🪟 Windows-MCP

Windows MCP 是一个轻量级、开源的项目，它能够实现AI代理与Windows操作系统之间的无缝集成。作为MCP服务器，它填补了大语言模型（LLMs）与Windows操作系统之间的空白，使代理能够执行诸如文件导航、应用程序控制、UI交互、QA测试等任务。

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

✨ 主要特性

无缝Windows集成
本机与Windows UI元素交互，打开应用程序，控制窗口，模拟用户输入等。
使用任何大语言模型（视觉可选） 与许多自动化工具不同，Windows MCP不依赖于任何传统的计算机视觉技术或特定的微调模型；它可以与任何大语言模型配合使用，减少了复杂性和设置时间。
丰富的UI自动化工具集
包括基本的键盘、鼠标操作以及捕获窗口/UI状态的工具。
轻量级且开源
最小依赖项，易于设置，并且源代码在MIT许可下完全可用。
可定制和可扩展
可以轻松适应或扩展工具，以满足您独特的自动化或AI集成需求。
实时交互
动作之间的典型延迟（例如，从一次鼠标点击到下一次）范围为4到8秒，并可能根据活动应用程序的数量和系统负载略有变化。

支持的操作系统

Windows 10
Windows 11

安装

前提条件

Python 3.12+
Anthropic Claude桌面应用程序或其他MCP客户端
UV（Python包管理器），通过pip install uv安装

🏁 开始使用

克隆仓库。

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

安装依赖项：

shell uv pip install -r pyproject.toml

连接到MCP服务器

复制以下JSON，并填写适当的{{PATH}}值：

json { "mcpServers": { "windows-mcp": { "command": "{{PATH_TO_UV}}", "args": [ "--directory", "{{PATH_TO_SRC}}/Windows-MCP", "run", "server.py" ] } } }

对于Claude，请将此文件保存为claude_desktop_config.json，在Claude桌面配置目录中：

shell %APPDATA%/Claude/claude_desktop_config.json

重启Claude桌面应用程序

打开Claude桌面应用程序，现在你应该可以看到Windows-MCP作为一个可用的集成选项。

有关额外的Claude桌面应用程序集成故障排除，请参阅MCP文档。该文档包括检查日志和解决常见问题的有用提示。

🛠️ MCP工具

Claude可以访问以下工具来与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: 活动应用程序和交互式UI元素的组合快照。
Screenshot-Tool: 捕获桌面的屏幕截图。
Launch-Tool: 从开始菜单启动一个应用程序。
Shell-Tool: 执行PowerShell命令。

⚠️注意事项

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

🪪许可

本项目采用MIT许可证 - 详情请参阅 LICENSE 文件。

🤝贡献

欢迎贡献！请参阅 CONTRIBUTING 获取设置说明和开发指南。

由 Jeomon George 用❤️制作

引用

bibtex @misc{ author = {George, Jeomon}, title = {Windows-MCP}, year = {2024}, publisher = {GitHub}, howpublished = {\url{https://github.com/Jeomon/Windows-MCP}}, note = {轻量级开源项目，用于将LLM代理与Windows集成} }

来源

来源：github
链接：https://github.com/Computer-Agent/Windows-MCP