GitHub Cursor Touch Windows MCP

](https://mseep.ai/app/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

🎥 演示

✨ 主要特点

• 无缝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. 安装 困惑桌面:

1. 克隆存储库。

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",
    "
",
    "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.

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

{
  "theme": "Default",
  ...
//MCP Server Config
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--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.

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

{
//MCP Server Config
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--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.

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

[mcp_servers.windows-mcp]
command="uv"
args=[
  "--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自动化功能：

• UI自动化

• PyAutoGUI

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

🤝贡献

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

由以下材料制成❤️ 通过 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}
}