AI导哈

Windows系统集成工具

Windows MCP是一个轻量级开源项目，实现AI代理与Windows操作系统的无缝集成，支持文件导航、应用控制、UI交互等功能。

  • by kbowers
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kbowers/https-github.com-CursorTouch-Windows-MCP

使用说明

🪟 Windows-MCP



Windows MCP 是一个轻量级的开源项目，可实现AI代理和Windows操作系统之间的无缝集成。充当MCP服务器弥合了LLM和Windows操作系统之间的差距，允许代理执行以下任务 文件导航、应用程序控制、UI交互、QA测试、， 以及更多。

mcp名称：io.github。CursorTouch/Windows MCP

更新

  • Windows MCP已添加到 MCP注册表
  • 试试🪟Windows使用！！，使用Windows MCP构建的代理。
  • Windows MCP现在作为桌面扩展在 Claude Desktop.

支持的操作系统

  • Windows 7
  • Windows 8，8.1
  • Windows 10
  • Windows 11

🎥 演示

https://github.com/user-attachments/assets/d0e7ed1d-6189-4de6-838a-5ef8e1cad54e

https://github.com/user-attachments/assets/d2b372dc-8d00-4d71-9677-4c64f5987485

✨ 主要特点

  • 无缝Windows集成
    与Windows UI元素进行本机交互，打开应用程序，控制窗口，模拟用户输入等。

  • 使用任何LLM（视觉可选） 与许多自动化工具不同，Windows MCP不依赖于任何传统的计算机视觉技术或特定的微调模型；它适用于任何LLM，降低了复杂性和设置时间。

  • 丰富的UI自动化工具集
    包括用于基本键盘、鼠标操作和捕获窗口/UI状态的工具。

  • 轻量级和开源
    最小的依赖关系和简单的设置，在MIT许可下提供完整的源代码。

  • 可定制和可扩展
    轻松调整或扩展工具，以满足您独特的自动化或人工智能集成需求。

  • 实时交互
    操作之间的典型延迟（例如，从一次鼠标点击到下一次）范围为 0.7至2.5秒，并且可能会根据活动应用程序的数量和系统负载以及llm的推理速度而略有不同。

🛠️安装

先决条件

  • Python 3.13+
  • Astra的UV（软件包管理器），与 pip install uv 或 curl -LsSf https://astral.sh/uv/install.sh | sh
  • English 作为Windows中的默认语言，强烈推荐或禁用 Launch-Tool 和 Switch-Tool 在适用于Windows的MCP Server中使用其他语言。
Install in Claude Desktop
  1. 安装 克劳德桌面 和
npm install -g @anthropic-ai/mcpb
  1. 克隆存储库。
git clone https://github.com/CursorTouch/Windows-MCP.git

cd Windows-MCP
  1. 构建桌面扩展 MCPB:
npx @anthropic-ai/mcpb pack
  1. 打开克劳德桌面：

首选 Settings->Extensions->Advance Settings->Install Extension （定位 .mcpb 文件）->安装

  1. 享受🥳.

有关其他Claude Desktop集成故障排除，请参阅 MCP文件。该文档包括检查日志和解决常见问题的有用提示。

Install in Perplexity Desktop

  1. 安装 困惑桌面:

  2. 克隆存储库。

git clone https://github.com/CursorTouch/Windows-MCP.git

cd Windows-MCP
  1. 打开困惑桌面：

首选 Settings->Connectors->Add Connector->Advanced

  1. 输入名称如下 Windows-MCP，然后将以下JSON粘贴到文本区域。
{
  "command": "uv",
  "args": [
    "--directory",
    "<path to the windows-mcp directory>",
    "run",
    "main.py"
  ]
}
  1. 点击 Save 并享受🥳.

有关其他Claude Desktop集成故障排除，请参阅 困惑MCP支持。该文档包括检查日志和解决常见问题的有用提示。

Install in Gemini CLI
  1. 安装Gemini CLI：
npm install -g @google/gemini-cli
  1. 克隆存储库。
git clone https://github.com/CursorTouch/Windows-MCP.git

cd Windows-MCP

  1. 导航至 %USERPROFILE%/.gemini 在文件资源管理器中打开 settings.json.

  2. 添加 windows-mcp 配置在 settings.json 并保存它。

{
  "theme": "Default",
  ...
//MCP Server Config
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path to the windows-mcp directory>",
        "run",
        "main.py"
      ]
    }
  }
}
  1. 在终端中重新运行Gemini CLI。享受🥳
Install in Qwen Code 1. Install Qwen Code: 
npm install -g @qwen-code/qwen-code@latest
  1. 克隆存储库。
git clone https://github.com/CursorTouch/Windows-MCP.git

cd Windows-MCP

  1. 导航至 %USERPROFILE%/.qwen/settings.json.

  2. 添加 windows-mcp 配置在 settings.json 并保存它。

{
//MCP Server Config
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path to the windows-mcp directory>",
        "run",
        "main.py"
      ]
    }
  }
}
  1. 在终端中重新运行Qwen Code。享受🥳
Install in Codex CLI 1. Install Codex CLI: 
npm install -g @openai/codex
  1. 克隆存储库。
git clone https://github.com/CursorTouch/Windows-MCP.git

cd Windows-MCP

  1. 导航至 %USERPROFILE%/.codex/config.toml.

  2. 添加 windows-mcp 配置在 config.toml 并保存它。

[mcp_servers.windows-mcp]
command="uv"
args=[
  "--directory",
  "<path to the windows-mcp directory>",
  "run",
  "main.py"
]
  1. 在终端中重新运行Codex CLI。享受🥳

🔨MCP工具

MCP客户端可以访问以下工具与Windows交互：

  • Click-Tool：在给定坐标处单击屏幕。
  • Type-Tool：在元素上键入文本（可选择清除现有文本）。
  • Clipboard-Tool：使用系统剪贴板复制或粘贴。
  • Scroll-Tool：在窗口或特定区域上垂直或水平滚动。
  • Drag-Tool：从一个点拖动到另一个点。
  • Move-Tool：移动鼠标指针。
  • Shortcut-Tool：按键盘快捷键(Ctrl+c, Alt+Tab等等）。
  • Key-Tool：按一个键。
  • Wait-Tool：暂停一段规定的时间。
  • State-Tool：默认语言、浏览器、活动应用程序和交互式、文本和可滚动元素的组合快照，以及桌面截图。
  • Resize-Tool：用于更改应用程序的窗口大小或位置。
  • Launch-Tool：从“开始”菜单启动应用程序。
  • Shell-Tool：执行PowerShell命令。
  • Scrape-Tool：抓取整个网页以获取信息。

🤝 联系我们

保持更新并加入我们的社区：

明星历史

⚠️小心

此MCP直接与您的Windows操作系统交互以执行操作。谨慎使用，避免在不能容忍此类风险的环境中部署。

📝 局限性

  • 在段落中选择文本的特定部分，因为MCP依赖于11y树。（⌛正在努力。）
  • Type-Tool 用于键入文本，而不是在IDE中编程，因为它在文件中键入整个程序。（⌛正在努力。）
  • 此MCP服务器不能用于玩视频游戏。

🪪许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

Windows MCP利用了几个优秀的开源项目来支持其Windows自动化功能：

非常感谢这些库的维护者和贡献者所做的杰出工作和开源精神。

🤝贡献

欢迎投稿！请看 贡献 有关设置说明和开发指南。

由以下材料制成❤️ 通过 CursorTouch

引用

@software{
  author       = {CursorTouch},
  title        = {Windows-MCP: Lightweight open-source project for integrating LLM agents with Windows},
  year         = {2024},
  publisher    = {GitHub},
  url={https://github.com/CursorTouch/Windows-MCP}
}

相关 MCP