mcp-windows

mcp-windows

site icon
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 系统操作
  • 媒体控制应用
  • 窗口管理工具
  • 系统监控工具
  • 主题切换工具
  • 剪贴板管理工具

使用教程

使用依赖

无明确前置依赖要求。

安装教程

  1. 在 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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。