
mcp-windows

2025.04.19
2
PythonWindows API 操作系统自动化其它
mcp-windows 是一个针对 Windows API 的 MCP 服务器,提供了丰富的 Windows 系统操作功能,包括媒体控制、通知发送、窗口管理、截图、显示器控制、主题设置、开始菜单操作和剪贴板管理等功能。
View on GitHub
Overview
基本能力
产品定位
mcp-windows 是一个针对 Windows API 的 MCP 服务器,提供了丰富的 Windows 系统操作功能。
核心功能
- 媒体控制:获取媒体会话、暂停、播放、下一曲、上一曲
- 通知发送:发送 toast 通知
- 窗口管理:获取前台窗口信息、获取窗口列表、聚焦窗口、关闭窗口、最小化窗口
- 截图:窗口截图
- 显示器控制:睡眠显示器、唤醒显示器
- 主题设置:设置主题模式(亮色、暗色)、获取主题模式
- 开始菜单操作:打开文件、打开 URL
- 剪贴板管理:获取剪贴板内容、设置剪贴板内容
适用场景
- 自动化 Windows 系统操作
- 媒体控制应用
- 窗口管理工具
- 系统监控工具
- 主题切换工具
- 剪贴板管理工具
使用教程
使用依赖
无明确前置依赖要求。
安装教程
- 在 Claude MCP 配置中添加以下内容:
{
"mcpServers": {
"windows": {
"command": "uvx",
"args": [
"mcp-windows"
]
}
}
}
或本地安装:
{
"mcpServers": {
"windows": {
"command": "uv",
"args": [
"--directory",
"C:\\Users\\{name}\\Documents\\mcp-windows",
"run",
"mcp-windows"
]
}
}
}
调试方式
安装完成后,可以通过调用提供的 API 功能进行调试,例如:
- 获取媒体会话:get_media_sessions
- 发送通知:send_toast
- 获取窗口列表:get_window_list