MCP控制
模型上下文协议的 Windows 控制服务器,提供对系统操作(包括鼠标、键盘、窗口管理和屏幕捕获功能)的编程控制。
注意:该项目目前仅支持 Windows。
🔥 为什么选择 MCPControl?
MCPControl 弥合了 AI 模型和桌面之间的差距,实现了安全的程序化控制:
- 🖱️鼠标移动和点击
- ⌨️键盘输入和快捷键
- 🪟窗口管理
- 📸屏幕截图和分析
- 📋剪贴板操作
🔌 快速入门
- 安装 Node.js (如果尚未安装)
# Visit https://nodejs.org and download the latest LTS version
- 在您的 Claude 客户端中配置 MCP 设置:
{
"mcpServers": {
"MCPControl": {
"command": "npx",
"args": [
"--no-cache",
"-y",
"mcp-control"
]
}
}
}
- 重新启动您的客户端,MCPControl 将出现在您的 MCP 菜单中!
🚀 热门用例
辅助自动化
- 应用程序测试:将重复的 UI 测试委托给 Claude,让 AI 浏览应用程序并报告问题
- 工作流自动化:让 Claude 代表您操作应用程序,处理重复性任务,而您则专注于创造性工作
- 表格填写:让 Claude 在您的监督下处理数据录入任务
人工智能实验
- 人工智能游戏:观看克劳德通过视觉反馈学习玩简单游戏
- 视觉推理:测试克劳德浏览视觉界面和解决视觉谜题的能力
- 人机协作:探索新的交互范式,克劳德可以看到你的屏幕并帮助完成复杂的任务
开发和测试
- 跨应用程序集成:桥接通常不通信的应用程序
- UI 测试框架:通过视觉验证创建强大的测试场景
- 演示创建:自动创建产品演示
⚠️ 重要免责声明
本软件尚处于实验阶段,存在潜在危险
通过使用此软件,您承认并接受:
- 通过此工具让人工智能模型直接控制你的计算机本身就存在风险
- 该软件可以控制您的鼠标、键盘和其他系统功能,可能会导致意外后果
- 您自行承担使用该软件的全部风险。
- 本项目的创建者和贡献者对于因使用本软件而造成的任何损害、数据丢失或其他后果不承担任何责任
- 此工具仅应在有适当安全措施的受控环境中使用
使用风险自负
🌟 功能
🛠️ 开发设置
如果您有兴趣贡献或从源代码构建,请参阅CONTRIBUTING.md获取详细说明。
开发要求
要构建此项目进行开发,您需要:
- Windows 操作系统(keysender 依赖项所需)
- Node.js 18 或更高版本(使用包含构建工具的官方 Windows 安装程序安装)
- npm 包管理器
- 原生构建工具:
- 节点-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 文件。
📖 参考文献