mcpField
M
mcp-windows

mcp-windows

本地服务
github.com/SecretiveShell其他2379 周前更新
代码仓库

关于 mcp-windows

mcp-windows 是一个面向 Windows API 的 MCP 服务，可让 MCP 客户端调用系统级功能。适合需要通过 Claude 等客户端控制 Windows 桌面的用户。

主要功能

  1. 01媒体会话查询与播放控制
  2. 02发送系统通知（Toast）
  3. 03窗口列表、聚焦、最小化与关闭
  4. 04窗口截图
  5. 05显示器休眠与唤醒
  6. 06浅色与深色主题切换
  7. 07剪贴板读写

适用场景

  1. 01通过 AI 客户端控制媒体播放
  2. 02管理当前打开的窗口
  3. 03读取或修改系统剪贴板内容

MCP 相关

该项目是一个 MCP 服务，将 Windows API 功能以工具形式暴露给 MCP 客户端。配置方式为在客户端的 mcpServers 中通过 uvx 或本地 uv 启动。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "windows": {
      "command": "uvx",
      "args": [
        "mcp-windows"
      ]
    }
  }
}
启动命令uvx mcp-windows

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-windows

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-windows

用于 Windows API 的 MCP 服务。

安装

将以下内容添加到你的 claude MCP 配置中：

{
  "mcpServers": {
    "windows": {
      "command": "uvx",
      "args": [
        "mcp-windows"
      ]
    }
  }
}

或在本地运行：

{
  "mcpServers": {
    "windows": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\{name}\\Documents\\mcp-windows",
        "run",
        "mcp-windows"
      ]
    }
  }
}

功能

媒体
  • get_media_sessions
  • pause
  • play
  • next
  • previous
通知
  • send_toast
窗口管理
  • get_foreground_window_info
  • get_window_list
  • focus_window
  • close_window
  • minimize_window
截图
  • screenshot_window
显示器
  • sleep_monitors
  • wake_monitors
主题
  • set_theme_mode (light, dark)
  • get_theme_mode
开始菜单
  • open_file
  • open_url
剪贴板
  • get_clipboard
  • set_clipboard

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。