光标控制MCP服务器
MCP服务器，使AI代理能够通过安全护栏控制鼠标光标和键盘。
特性
- 鼠标控制：移动、单击、双击、右键单击、拖动、滚动
- 键盘控制：键入文本、按键、热键组合
- 截图：捕获全屏或区域
- 安全：基于会话的控制、终止开关、动作日志记录
安装
pip install -e .用法
启动服务器
cursor-control-mcp [config.yaml]使用Claude Desktop进行配置
增添 claude_desktop_config.json:
{
"mcpServers": {
"cursor-control": {
"command": "cursor-control-mcp",
"args": ["/path/to/config.yaml"]
}
}
}工具
| 工具 | 说明 |
|---|---|
screenshot | 捕获屏幕或区域 |
move_cursor | 将光标移动到坐标 |
click | 点击位置 |
double_click | 双击位置 |
drag | 从一个点拖动到另一个点 |
scroll | 滚动鼠标滚轮 |
type_text | 键入文本字符串 |
press_key | 按带有修改器的键 |
hotkey | 按组合键 |
get_status | 获取会话状态和屏幕信息 |
request_control | 启动控制会话 |
release_control | 结束控制会话 |
get_action_log | 获取最近的操作历史记录 |
安全
紧急停止开关
按 Ctrl+Alt+Escape （可配置）以立即结束会话。
会话控制
- 会话具有最长持续时间（默认值：30分钟）
- 所有操作都记录到SQLite数据库中
- 没有活动会话就无法控制（屏幕截图除外）
运行日志
每个操作都会记录时间戳和参数。查看日志：
# Via MCP tool
get_action_log(last_n=50)配置
看 config.yaml 对于选项：
max_session_minutes: 30
kill_switch_hotkey: [ctrl, alt, escape]
log_all_actions: true
log_path: "~/.cursor-control-mcp/actions.db"需求
- Python 3.10+
- 视窗：开箱即用
- macOS：开箱即用
- Linux：需要X11显示器（Wayland部分支持）
平台特定安装
# Windows
pip install -e ".[windows]"
# Linux
pip install -e ".[linux]"
# macOS
pip install -e .许可证
麻省理工学院