go_computer_use_mcp_server

[!WARNING] This server is intended to run as a trusted local MCP tool.
It currently provides broad local desktop control and is not sandboxed by default.
Do not expose it to untrusted networks, users, or agents without additional security controls.

MCP (Model Context Protocol) server in Go for computer automation. Uses robotgo library for desktop automation.

Features

• Mouse control: movement, clicks, dragging, scrolling
• Keyboard control: key presses, text input, hotkeys
• Screen operations: screenshots, pixel color, display information
• Window management: move, resize, minimize/maximize
• Process management: list processes, search, terminate
• System utilities: system info, dialogs, delays

Quick Start with npx

The easiest way to run the server is via npx (requires 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

Official MCP Registry

This server is prepared for publication in the Official MCP Registry as:

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

Registry metadata is defined in server.json. The npm package includes a matching mcpName field in package.json, which the registry uses to verify package ownership.

For maintainers, the release workflow publishes the npm package first, waits until that package version is visible in the npm registry, then publishes server.json with GitHub OIDC authentication.

Integration with AI Tools

Claude Desktop

Add to your Claude Desktop configuration file:

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

Using CLI command:

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

Or add manually to your project's .mcp.json file:

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

OpenCode

Add to your opencode.jsonc configuration file:

{
  "$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)

Using CLI command:

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

Or add to ~/.codex/config.toml:

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

Cursor

Add to your Cursor MCP configuration. Go to Cursor Settings > Features > MCP Servers and add:

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

Windsurf

Add to ~/.codeium/mcp_config.json or via Settings > Cascade > MCP Servers > Add Server:

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

Cline (VS Code Extension)

Click the MCP Servers icon in Cline panel, select "Configure" tab, then "Configure MCP Servers" to edit cline_mcp_settings.json:

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

Generic MCP Client

For any MCP-compatible client, use:

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

Installation from Source

Requirements

• Go 1.21+
• GCC compiler
• X11 libraries (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

One-liner:

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

One-liner:

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

Build

# Download dependencies
make deps

# Build for current platform
make build

# Build for all platforms
make build-all

Running (from source)

SSE transport (default)

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

Stdio transport

./go_computer_use_mcp_server -t stdio

Command line arguments

| Argument | Description | Default | |----------|-------------|---------| | -t | Transport: sse or stdio | sse | | -h | Host for SSE server | 0.0.0.0 | | -p | Port for SSE server | 8080 |

Available Tools

Mouse Control (12 tools)

| Tool | Description | |------|-------------| | mouse_move | Move cursor to absolute coordinates | | mouse_move_smooth | Smooth cursor movement (human-like) | | mouse_move_relative | Relative cursor movement | | mouse_get_position | Get current cursor position | | mouse_click | Mouse click | | mouse_click_at | Move and click | | mouse_toggle | Press/release mouse button | | mouse_drag | Drag operation | | mouse_drag_smooth | Smooth drag operation | | mouse_scroll | Scroll | | mouse_scroll_direction | Scroll in direction | | mouse_scroll_smooth | Smooth scroll |

Keyboard Control (7 tools)

| Tool | Description | |------|-------------| | key_tap | Key press (with modifiers) | | key_toggle | Press/release key | | type_text | Type text (UTF-8) | | type_text_delayed | Type text with delay | | clipboard_read | Read clipboard | | clipboard_write | Write to clipboard | | clipboard_paste | Paste via clipboard |

Screen Operations (7 tools)

| Tool | Description | |------|-------------| | screen_get_size | Get screen size | | screen_get_displays_num | Number of monitors | | screen_get_display_bounds | Monitor bounds | | screen_capture | Screen capture (returns MCP ImageContent) | | screen_capture_save | Capture and save to file | | screen_get_pixel_color | Pixel color at coordinates | | screen_get_mouse_color | Pixel color under cursor |

Window Management (9 tools)

| Tool | Description | |------|-------------| | window_get_active | Active window information | | window_get_title | Window title | | window_get_bounds | Window bounds | | window_set_active | Activate window | | window_move | Move window | | window_resize | Resize window | | window_minimize | Minimize window | | window_maximize | Maximize window | | window_close | Close window |

Process Management (6 tools)

| Tool | Description | |------|-------------| | process_list | List all processes | | process_find_by_name | Find processes by name | | process_get_name | Get process name by PID | | process_exists | Check if process exists | | process_kill | Kill process | | process_run | Run command |

System Utilities (3 tools)

| Tool | Description | |------|-------------| | system_get_info | System information | | util_sleep | Sleep/delay | | alert_show | Show dialog |

Usage Examples

Move mouse and click

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

Type text

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

Hotkeys

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

Screen capture

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

Supported Keys

Letters and numbers

a-z, A-Z, 0-9

Function keys

f1-f24

Navigation

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

Special keys

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

Modifiers

alt, ctrl, shift, cmd (or command)

Multimedia

audio_mute, audio_vol_down, audio_vol_up, audio_play, audio_stop, audio_pause

License

MIT