CursorTouch

<div align="center"> <h1>🪟 Windows-MCP</h1> <a href="https://github.com/Computer-Agent/Windows-MCP/blob/main/LICENSE"> <img src="https://img.shields.io/badge/license-MIT-green" alt="License"> </a> <img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="Python"> <img src="https://img.shields.io/badge/platform-Windows%2010%20%7C%2011-blue" alt="Platform"> <img src="https://img.shields.io/github/last-commit/Computer-Agent/Windows-MCP" alt="Last Commit"> <br> <a href="https://x.com/CursorTouch"> <img src="https://img.shields.io/badge/follow-%40CursorTouch-1DA1F2?logo=twitter&style=flat" alt="Follow on Twitter"> </a> <a href="https://discord.com/invite/Aue9Yj2VzS"> <img src="https://img.shields.io/badge/Join%20on-Discord-5865F2?logo=discord&logoColor=white&style=flat" alt="Join us on Discord"> </a> </div> <br>

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安装

🏁 开始使用

1. 克隆仓库。

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

1. 安装依赖项：

shell uv pip install -r pyproject.toml

1. 连接到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

1. 重启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集成} }