Screen Control MCP

屏幕控制MCP服务器

MCP服务器，允许您查看操作系统中的所有屏幕并控制鼠标和键盘，因此您可以在屏幕上的任何位置单击并键入文本。

功能

• 📺 屏幕预览： 抓取所有屏幕或特定屏幕的截图
• 🖱️ 鼠标控制移动鼠标指针，单击，双击，滚动
• ⌨️ Tangentbords控球键入文本、按键和按键组合
• 🖥️ 多屏幕支持多个屏幕/显示器

安装

条件

• Node.js 18 或更高版本
• npm或纱线
• MacOS、Linux或Windows

斯特格

1. 克隆报告 ：

git clone https://github.com/peteraspenberg/screen-control-mcp.git
cd screen-control-mcp

1. Installera依赖关系：

npm install

对 macOS 很重要: robotjs 需要 native compilation。如果在安装过程中出错：

# Installera Xcode Command Line Tools om de saknas
xcode-select --install

# Försök installera igen
npm install

1. 构建工程 ：

npm run build

光标配置

在 Cursor MCP 配置中添加以下内容（例如： ~/.cursor/mcp.json 或等效）：

{
  "mcpServers": {
    "screen-control": {
      "command": "node",
      "args": ["/absolut/sökväg/till/screen-control-mcp/dist/index.js"]
    }
  }
}

或者，如果要从工作文件夹运行：

{
  "mcpServers": {
    "screen-control": {
      "command": "node",
      "args": ["/Users/peteraspenberg/screen-control-mcp/dist/index.js"]
    }
  }
}

可用工具

list_screens

列出系统上所有可用的屏幕/显示器。

capture_screen

拍摄特定屏幕或所有屏幕的截图。将图像作为 base64 数据 URI 返回。

参数记录器：

• screenId （可选）：要捕捉的屏幕ID（0索引）。如果未指定，则捕获所有屏幕。
• format （可选）：图像格式（“png”或“jpg”，默认：“png”）

get_screen_info

获取所有屏幕信息（分辨率，位置等）

move_mouse

将鼠标指针移动到指定的坐标上 。

参数记录器：

• x：X-koordinat
• y：Y-koordinat
• screenId （可选）：屏幕ID（0索引）

click_mouse

用鼠标点击指定的坐标 。

参数记录器：

• x：X-koordinat
• y：Y-koordinat
• button （可选）：麝香草（“左”、“右”、“中”，标准：“左”）
• doubleClick （可选）：双击（默认：false）
• screenId （可选）：屏幕ID（0索引）

scroll_mouse

滚动鼠标滚轮。

参数记录器：

• x：X-koordinat
• y：Y-koordinat
• direction：滚动（“向上”、“向下”、“向左”、“向右”）
• clicks （可选）：心腹卷轴（标准：3）
• screenId （可选）：屏幕ID（0索引）

type_text

在当前光标位置或指定坐标上键入文本 。

参数记录器：

• text要写的文本
• x （可选）：写入前点击的 X 坐标
• y （可选）： 写入前点击的 Y 坐标
• screenId （可选）：屏幕ID（0索引）

press_key

按下按键或按键组合。

参数记录器：

• key要按的键（例如“enter”，“tab”，“space”，“cmd+c”，“ctrl+shift+t”）

get_mouse_position

调整你当前的肌肉位置。

例子

抓取屏幕截图

{
  "tool": "capture_screen",
  "arguments": {
    "screenId": 0,
    "format": "png"
  }
}

点击屏幕

{
  "tool": "click_mouse",
  "arguments": {
    "x": 100,
    "y": 200,
    "button": "left"
  }
}

Skriv文本

{
  "tool": "type_text",
  "arguments": {
    "text": "Hej världen!",
    "x": 500,
    "y": 300
  }
}

按键组合

{
  "tool": "press_key",
  "arguments": {
    "key": "cmd+c"
  }
}

安全

⚠️ 重要此服务器可以完全控制您的鼠标和键盘。只能与您信任的认真人工智能助理一起使用。始终确保：

• 只从您信任的来源运行
• 不要将服务器暴露给未经授权的人
• 了解人工智能在使用这些工具时会做什么

发展

# Bygg projektet
npm run build

# Bygg i watch-läge
npm run dev

# Starta servern direkt (för testning)
npm start

许可证

麻省理工学院

拖拽

欢迎捐款！打开一个问题或一个pull请求。