MIT License
235
75

MCP控制

模型上下文协议的 Windows 控制服务器,提供对系统操作(包括鼠标、键盘、窗口管理和屏幕捕获功能)的编程控制。

注意:该项目目前仅支持 Windows。

🔥 为什么选择 MCPControl?

MCPControl 弥合了 AI 模型和桌面之间的差距,实现了安全的程序化控制:

  • 🖱️鼠标移动和点击
  • ⌨️键盘输入和快捷键
  • 🪟窗口管理
  • 📸屏幕截图和分析
  • 📋剪贴板操作

🔌 快速入门

  1. 安装 Node.js (如果尚未安装)
    # Visit https://nodejs.org and download the latest LTS version
  2. 在您的 Claude 客户端中配置 MCP 设置
    { "mcpServers": { "MCPControl": { "command": "npx", "args": [ "--no-cache", "-y", "mcp-control" ] } } }
  3. 重新启动您的客户端,MCPControl 将出现在您的 MCP 菜单中!

🚀 热门用例

辅助自动化

  • 应用程序测试:将重复的 UI 测试委托给 Claude,让 AI 浏览应用程序并报告问题
  • 工作流自动化:让 Claude 代表您操作应用程序,处理重复性任务,而您则专注于创造性工作
  • 表格填写:让 Claude 在您的监督下处理数据录入任务

人工智能实验

  • 人工智能游戏:观看克劳德通过视觉反馈学习玩简单游戏
  • 视觉推理:测试克劳德浏览视觉界面和解决视觉谜题的能力
  • 人机协作:探索新的交互范式,克劳德可以看到你的屏幕并帮助完成复杂的任务

开发和测试

  • 跨应用程序集成:桥接通常不通信的应用程序
  • UI 测试框架:通过视觉验证创建强大的测试场景
  • 演示创建:自动创建产品演示

⚠️ 重要免责声明

本软件尚处于实验阶段,存在潜在危险

通过使用此软件,您承认并接受:

  • 通过此工具让人工智能模型直接控制你的计算机本身就存在风险
  • 该软件可以控制您的鼠标、键盘和其他系统功能,可能会导致意外后果
  • 您自行承担使用该软件的全部风险。
  • 本项目的创建者和贡献者对于因使用本软件而造成的任何损害、数据丢失或其他后果不承担任何责任
  • 此工具仅应在有适当安全措施的受控环境中使用

使用风险自负

🌟 功能

🛠️ 开发设置

如果您有兴趣贡献或从源代码构建,请参阅CONTRIBUTING.md获取详细说明。

开发要求

要构建此项目进行开发,您需要:

  1. Windows 操作系统(keysender 依赖项所需)
  2. Node.js 18 或更高版本(使用包含构建工具的官方 Windows 安装程序安装)
  3. npm 包管理器
  4. 原生构建工具:
    • 节点-gyp: npm install -g node-gyp
    • cmake-js: npm install -g cmake-js

keysender 依赖项依赖于需要这些构建工具的 Windows 特定本机模块。

📋 项目结构

  • /src
    • /handlers请求处理程序和工具管理
    • /tools核心功能实现
    • /types - TypeScript 类型定义
    • index.ts - 主应用程序入口点

🔖 仓库分支

  • main - 具有最新功能和变化的主要开发分支
  • release - 镜像最新稳定标签的稳定发布分支(当前为 v0.1.22)

版本安装

您可以使用 npm 安装特定版本的 MCPControl:

# Install the latest stable release (from release branch) npm install mcp-control # Install a specific version npm install mcp-control@0.1.22

📚 依赖项

🚧 已知限制

  • 目前不支持窗口最小化/恢复操作
  • 根据设置,多屏幕功能可能无法按预期工作
  • get_screenshot 实用程序不适用于 VS Code 扩展 Cline。请参阅GitHub 问题 #1865。
  • 根据目标应用程序,某些操作可能需要提升权限
  • 仅支持 Windows
  • 目前,点击精度在 1280x720 分辨率、单屏下效果最佳。我们正在修复偏移/缩放错误,并正在寻找测试人员或帮助创建测试工具

👥 贡献

参见CONTRIBUTING.md

⚖️ 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。

📖 参考文献

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

模型上下文协议的 Windows 控制服务器,提供对系统操作(包括鼠标、键盘、窗口管理和屏幕捕获功能)的编程控制。

  1. 🔥 Why MCPControl?
    1. 🔌 Quick Start
      1. 🚀 Popular Use Cases
        1. Assisted Automation
        2. AI Experimentation
        3. Development and Testing
      2. ⚠️ IMPORTANT DISCLAIMER
        1. 🌟 Features
          1. 🛠️ Development Setup
            1. Development Requirements
          2. 📋 Project Structure
            1. 🔖 Repository Branches
              1. Version Installation
            2. 📚 Dependencies
              1. 🚧 Known Limitations
                1. 👥 Contributing
                  1. ⚖️ License
                    1. 📖 References

                      Related MCP Servers

                      • A
                        security
                        A
                        license
                        A
                        quality
                        A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
                        Last updated 4 months ago
                        3
                        9
                        36
                        JavaScript
                        Apache 2.0
                      • A
                        security
                        A
                        license
                        A
                        quality
                        A Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.
                        Last updated 2 months ago
                        9
                        350
                        105
                        JavaScript
                        MIT License
                      • -
                        security
                        -
                        license
                        -
                        quality
                        A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
                        Last updated 24 days ago
                        2
                      • -
                        security
                        A
                        license
                        -
                        quality
                        Provides automated GUI testing and control capabilities through an MCP server that enables mouse movements, keyboard input, screen captures, and image recognition across Windows, macOS, and Linux.
                        Last updated a month ago
                        6
                        Python
                        MIT License
                        • Apple
                        • Linux

                      View all related MCP servers

                      ID: r3fdu3l0yz