🪟 Windows-MCP
Windows MCP 是一个轻量级的开源项目，可实现AI代理和Windows操作系统之间的无缝集成。充当MCP服务器弥合了LLM和Windows操作系统之间的差距，允许代理执行以下任务 文件导航、应用程序控制、UI交互、QA测试、， 以及更多。
mcp名称：io.github。CursorTouch/Windows MCP
更新
支持的操作系统
- 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
- 安装 克劳德桌面 和
npm install -g @anthropic-ai/mcpb- 克隆存储库。
git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP- 构建桌面扩展
MCPB:
npx @anthropic-ai/mcpb pack- 打开克劳德桌面：
首选 Settings->Extensions->Advance Settings->Install Extension （定位 .mcpb 文件）->安装
- 享受🥳.
有关其他Claude Desktop集成故障排除，请参阅 MCP文件。该文档包括检查日志和解决常见问题的有用提示。
Install in Perplexity Desktop
- 安装 困惑桌面:
- 克隆存储库。
git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP- 打开困惑桌面：
首选 Settings->Connectors->Add Connector->Advanced
- 输入名称如下
Windows-MCP，然后将以下JSON粘贴到文本区域。
{
"command": "uv",
"args": [
"--directory",
"
",
"run",
"main.py"
]
}- 点击
Save并享受🥳.
有关其他Claude Desktop集成故障排除，请参阅 困惑MCP支持。该文档包括检查日志和解决常见问题的有用提示。
Install in Gemini CLI
- 安装Gemini CLI：
npm install -g @google/gemini-cli- 克隆存储库。
git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP- 导航至
%USERPROFILE%/.gemini在文件资源管理器中打开settings.json.
- 添加
windows-mcp配置在settings.json并保存它。
{
"theme": "Default",
...
//MCP Server Config
"mcpServers": {
"windows-mcp": {
"command": "uv",
"args": [
"--directory",
"
",
"run",
"main.py"
]
}
}
}- 在终端中重新运行Gemini CLI。享受🥳
Install in Qwen Code 1. Install Qwen Code:
npm install -g @qwen-code/qwen-code@latest- 克隆存储库。
git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP- 导航至
%USERPROFILE%/.qwen/settings.json.
- 添加
windows-mcp配置在settings.json并保存它。
{
//MCP Server Config
"mcpServers": {
"windows-mcp": {
"command": "uv",
"args": [
"--directory",
"
",
"run",
"main.py"
]
}
}
}- 在终端中重新运行Qwen Code。享受🥳
Install in Codex CLI 1. Install Codex CLI:
npm install -g @openai/codex- 克隆存储库。
git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP- 导航至
%USERPROFILE%/.codex/config.toml.
- 添加
windows-mcp配置在config.toml并保存它。
[mcp_servers.windows-mcp]
command="uv"
args=[
"--directory",
"
",
"run",
"main.py"
]- 在终端中重新运行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}
}