# CursorTouch
## 基本信息
- Slug: `cursortouch-windows-mcp`
- Source: modelscope
- Publisher: @CursorTouch/Windows-MCP
- Categories: os-automation / app-automation / agent-orchestration
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@CursorTouch/Windows-MCP
## 简介
暂无描述。
## MCP Server 详情

<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


2. 安装依赖项：

shell
uv pip install -r pyproject.toml


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


4. 重启Claude桌面应用程序

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

有关额外的Claude桌面应用程序集成故障排除，请参阅[MCP文档](https://modelcontextprotocol.io/quickstart/server#claude-for-desktop-integration-issues)。该文档包括检查日志和解决常见问题的有用提示。

---

## 🛠️ 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](LICENSE) 文件。

## 🤝贡献

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

由 [Jeomon George](https://github.com/Jeomon) 用❤️制作

## 引用

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