AI导哈

光标控制MCP服务器

一个为AI代理提供鼠标和键盘控制能力的MCP服务器，具有安全防护机制。

  • by ErwanLorteau
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ErwanLorteau/cursor-control-mcp

使用说明

光标控制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 .

许可证

麻省理工学院

相关 MCP