Skip to main content
Glama
deenesjakoruzh
hightemp

go_computer_use_mcp_server

by hightemp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

go_computer_use_mcp_server

[!WARNING] 此服务器旨在作为受信任的本地 MCP 工具运行。 它目前提供广泛的本地桌面控制权限，且默认未进行沙箱隔离。 在没有额外安全控制的情况下，请勿将其暴露给不受信任的网络、用户或代理。

用于计算机自动化的 Go 语言 MCP (Model Context Protocol) 服务器。使用 robotgo 库进行桌面自动化。

功能

  • 鼠标控制：移动、点击、拖拽、滚动

  • 键盘控制：按键、文本输入、快捷键

  • 屏幕操作：截图、像素颜色、显示信息

  • 窗口管理：移动、调整大小、最小化/最大化

  • 进程管理：列出进程、搜索、终止

  • 系统工具：系统信息、对话框、延迟

Related MCP server: desktop-touch-mcp

使用 npx 快速启动

运行该服务器最简单的方法是通过 npx（需要 Node.js 18+）：

# Run with stdio transport (for MCP clients)
npx go-computer-use-mcp-server -t stdio

# Run with SSE transport
npx go-computer-use-mcp-server -t sse -h 0.0.0.0 -p 8080

官方 MCP 注册表

此服务器已准备好发布到官方 MCP 注册表，名称为：

io.github.hightemp/go-computer-use-mcp-server

注册表元数据定义在 server.json 中。npm 包在 package.json 中包含匹配的 mcpName 字段，注册表使用该字段来验证包的所有权。

对于维护者，发布工作流会先发布 npm 包，等待该包版本在 npm 注册表中可见，然后使用 GitHub OIDC 身份验证发布 server.json。

与 AI 工具集成

Claude Desktop

添加到您的 Claude Desktop 配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "computer-use": {
      "command": "npx",
      "args": ["-y", "go-computer-use-mcp-server", "-t", "stdio"]
    }
  }
}

Claude Code

使用 CLI 命令：

claude mcp add computer-use -- npx -y go-computer-use-mcp-server -t stdio
claude mcp add --transport stdio \
  --env DISPLAY="$DISPLAY" \
  --env XAUTHORITY="${XAUTHORITY:-$HOME/.Xauthority}" \
  computer-use -- \
  npx -y go-computer-use-mcp-server -t stdio

或者手动添加到您项目的 .mcp.json 文件中：

{
  "mcpServers": {
    "computer-use": {
      "command": "npx",
      "args": ["-y", "go-computer-use-mcp-server", "-t", "stdio"]
    }
  }
}

OpenCode

添加到您的 opencode.jsonc 配置文件中：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "computer-use": {
      "type": "local",
      "command": ["npx", "-y", "go-computer-use-mcp-server", "-t", "stdio"],
      "enabled": true
    }
  }
}

Codex (OpenAI)

使用 CLI 命令：

codex mcp add computer-use -- npx -y go-computer-use-mcp-server -t stdio

或者添加到 ~/.codex/config.toml：

[mcp_servers.computer-use]
command = "npx"
args = ["-y", "go-computer-use-mcp-server", "-t", "stdio"]
env_vars = ["DISPLAY", "XAUTHORITY"]

Cursor

添加到您的 Cursor MCP 配置中。前往 Cursor Settings > Features > MCP Servers 并添加：

{
  "mcpServers": {
    "computer-use": {
      "command": "npx",
      "args": ["-y", "go-computer-use-mcp-server", "-t", "stdio"]
    }
  }
}

Windsurf

添加到 ~/.codeium/mcp_config.json 或通过 Settings > Cascade > MCP Servers > Add Server：

{
  "mcpServers": {
    "computer-use": {
      "command": "npx",
      "args": ["-y", "go-computer-use-mcp-server", "-t", "stdio"]
    }
  }
}

Cline (VS Code 扩展)

点击 Cline 面板中的 MCP Servers 图标，选择“Configure”选项卡，然后点击“Configure MCP Servers”以编辑 cline_mcp_settings.json：

{
  "mcpServers": {
    "computer-use": {
      "command": "npx",
      "args": ["-y", "go-computer-use-mcp-server", "-t", "stdio"],
      "disabled": false
    }
  }
}

通用 MCP 客户端

对于任何兼容 MCP 的客户端，请使用：

npx -y go-computer-use-mcp-server -t stdio

从源码安装

要求

  • Go 1.21+

  • GCC 编译器

  • X11 库 (Linux)

Ubuntu/Debian

# Go (if not installed)
sudo snap install go --classic

# GCC
sudo apt install gcc libc6-dev

# X11
sudo apt install libx11-dev xorg-dev libxtst-dev

# Clipboard support
sudo apt install xsel xclip

# Bitmap support (for image operations)
sudo apt install libpng++-dev

# Event hook support
sudo apt install xcb libxcb-xkb-dev x11-xkb-utils libx11-xcb-dev libxkbcommon-x11-dev libxkbcommon-dev

一行命令：

sudo apt install gcc libc6-dev libx11-dev xorg-dev libxtst-dev xsel xclip libpng++-dev xcb libxcb-xkb-dev x11-xkb-utils libx11-xcb-dev libxkbcommon-x11-dev libxkbcommon-dev

Fedora

# GCC (if not installed)
sudo dnf install gcc

# X11
sudo dnf install libX11-devel libXtst-devel

# Clipboard support
sudo dnf install xsel xclip

# Bitmap support
sudo dnf install libpng-devel

# Event hook support
sudo dnf install libxkbcommon-devel libxkbcommon-x11-devel xorg-x11-xkb-utils-devel

一行命令：

sudo dnf install gcc libX11-devel libXtst-devel xsel xclip libpng-devel libxkbcommon-devel libxkbcommon-x11-devel xorg-x11-xkb-utils-devel

构建

# Download dependencies
make deps

# Build for current platform
make build

# Build for all platforms
make build-all

运行（从源码）

SSE 传输（默认）

./go_computer_use_mcp_server -t sse -h 0.0.0.0 -p 8080

Stdio 传输

./go_computer_use_mcp_server -t stdio

命令行参数

参数

描述

默认值

-t

传输方式：sse 或 stdio

sse

-h

SSE 服务器主机

0.0.0.0

-p

SSE 服务器端口

8080

可用工具

鼠标控制 (12 个工具)

工具

描述

mouse_move

将光标移动到绝对坐标

mouse_move_smooth

平滑移动光标（类人）

mouse_move_relative

相对移动光标

mouse_get_position

获取当前光标位置

mouse_click

鼠标点击

mouse_click_at

移动并点击

mouse_toggle

按下/释放鼠标按钮

mouse_drag

拖拽操作

mouse_drag_smooth

平滑拖拽操作

mouse_scroll

滚动

mouse_scroll_direction

向指定方向滚动

mouse_scroll_smooth

平滑滚动

键盘控制 (7 个工具)

工具

描述

key_tap

按键（带修饰键）

key_toggle

按下/释放按键

type_text

输入文本 (UTF-8)

type_text_delayed

延迟输入文本

clipboard_read

读取剪贴板

clipboard_write

写入剪贴板

clipboard_paste

通过剪贴板粘贴

屏幕操作 (7 个工具)

工具

描述

screen_get_size

获取屏幕尺寸

screen_get_displays_num

显示器数量

screen_get_display_bounds

显示器边界

screen_capture

屏幕截图（返回 MCP ImageContent）

screen_capture_save

截图并保存到文件

screen_get_pixel_color

获取坐标处的像素颜色

screen_get_mouse_color

获取光标下的像素颜色

窗口管理 (9 个工具)

工具

描述

window_get_active

活动窗口信息

window_get_title

窗口标题

window_get_bounds

窗口边界

window_set_active

激活窗口

window_move

移动窗口

window_resize

调整窗口大小

window_minimize

最小化窗口

window_maximize

最大化窗口

window_close

关闭窗口

进程管理 (6 个工具)

工具

描述

process_list

列出所有进程

process_find_by_name

按名称查找进程

process_get_name

通过 PID 获取进程名称

process_exists

检查进程是否存在

process_kill

终止进程

process_run

运行命令

系统工具 (3 个工具)

工具

描述

system_get_info

系统信息

util_sleep

休眠/延迟

alert_show

显示对话框

使用示例

移动鼠标并点击

{
  "tool": "mouse_click_at",
  "arguments": {
    "x": 100,
    "y": 200,
    "button": "left",
    "double": false
  }
}

输入文本

{
  "tool": "type_text",
  "arguments": {
    "text": "Hello, World!",
    "delay": 50
  }
}

快捷键

{
  "tool": "key_tap",
  "arguments": {
    "key": "c",
    "modifiers": ["ctrl"]
  }
}

屏幕截图

{
  "tool": "screen_capture",
  "arguments": {
    "x": 0,
    "y": 0,
    "width": 800,
    "height": 600
  }
}

支持的按键

字母和数字

a-z, A-Z, 0-9

功能键

f1-f24

导航键

up, down, left, right, home, end, pageup, pagedown

特殊键

backspace, delete, enter, tab, escape, space, insert, capslock

修饰键

alt, ctrl, shift, cmd (或 command)

多媒体键

audio_mute, audio_vol_down, audio_vol_up, audio_play, audio_stop, audio_pause

许可证

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Computer Control MCP

    AB498
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server that provides computer control capabilities including mouse movements, keyboard actions, screenshot capture with OCR, and window management through a unified API.
    197 PyPI
    167
    MIT

  • macos-control-mcp

    vito1317
    A
    license
    B
    quality
    D
    maintenance
    MCP server that enables AI to fully control macOS — mouse, keyboard, terminal, screenshots, window management, UI element detection, and provides AI-optimized information reporting.
    36
    28 npm
    MIT