go_computer_use_mcp_server

WARNING

Este servidor está diseñado para ejecutarse como unaherramienta MCP local de confianza. Actualmente proporciona un amplio control de escritorio local y no está aislado (sandboxed) por defecto. No lo exponga a redes, usuarios o agentes no confiables sin controles de seguridad adicionales.

Servidor MCP (Model Context Protocol) en Go para automatización informática. Utiliza la biblioteca robotgo para la automatización de escritorio.

Características

Control del ratón: movimiento, clics, arrastre, desplazamiento
Control del teclado: pulsaciones de teclas, entrada de texto, teclas de acceso rápido
Operaciones de pantalla: capturas de pantalla, color de píxel, información de pantalla
Gestión de ventanas: mover, cambiar tamaño, minimizar/maximizar
Gestión de procesos: listar procesos, buscar, terminar
Utilidades del sistema: información del sistema, cuadros de diálogo, retrasos

Inicio rápido con npx

La forma más sencilla de ejecutar el servidor es a través de npx (requiere 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

Integración con herramientas de IA

Claude Desktop

Agréguelo a su archivo de configuración de 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

Usando el comando 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

O agréguelo manualmente al archivo .mcp.json de su proyecto:

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

OpenCode

Agréguelo a su archivo de configuración 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)

Usando el comando CLI:

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

O agréguelo a ~/.codex/config.toml:

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

Cursor

Agréguelo a su configuración de MCP de Cursor. Vaya a Cursor Settings > Features > MCP Servers y añada:

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

Windsurf

Agréguelo a ~/.codeium/mcp_config.json o a través de Settings > Cascade > MCP Servers > Add Server:

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

Cline (Extensión de VS Code)

Haga clic en el icono de MCP Servers en el panel de Cline, seleccione la pestaña "Configure", luego "Configure MCP Servers" para editar cline_mcp_settings.json:

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

Cliente MCP genérico

Para cualquier cliente compatible con MCP, utilice:

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

Instalación desde el código fuente

Requisitos

Go 1.21+
Compilador GCC
Bibliotecas 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

Comando único:

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

Comando único:

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

Compilación

# Download dependencies
make deps

# Build for current platform
make build

# Build for all platforms
make build-all

Ejecución (desde el código fuente)

Transporte SSE (predeterminado)

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

Transporte Stdio

./go_computer_use_mcp_server -t stdio

Argumentos de línea de comandos

Argumento	Descripción	Predeterminado
`-t`	Transporte: `sse` o `stdio`	`sse`
`-h`	Host para el servidor SSE	`0.0.0.0`
`-p`	Puerto para el servidor SSE	`8080`

Herramientas disponibles

Control del ratón (12 herramientas)

Herramienta	Descripción
`mouse_move`	Mover el cursor a coordenadas absolutas
`mouse_move_smooth`	Movimiento suave del cursor (tipo humano)
`mouse_move_relative`	Movimiento relativo del cursor
`mouse_get_position`	Obtener la posición actual del cursor
`mouse_click`	Clic del ratón
`mouse_click_at`	Mover y hacer clic
`mouse_toggle`	Presionar/soltar botón del ratón
`mouse_drag`	Operación de arrastre
`mouse_drag_smooth`	Operación de arrastre suave
`mouse_scroll`	Desplazamiento
`mouse_scroll_direction`	Desplazamiento en una dirección
`mouse_scroll_smooth`	Desplazamiento suave

Control del teclado (7 herramientas)

Herramienta	Descripción
`key_tap`	Pulsación de tecla (con modificadores)
`key_toggle`	Presionar/soltar tecla
`type_text`	Escribir texto (UTF-8)
`type_text_delayed`	Escribir texto con retraso
`clipboard_read`	Leer portapapeles
`clipboard_write`	Escribir en el portapapeles
`clipboard_paste`	Pegar mediante el portapapeles

Operaciones de pantalla (7 herramientas)

Herramienta	Descripción
`screen_get_size`	Obtener tamaño de pantalla
`screen_get_displays_num`	Número de monitores
`screen_get_display_bounds`	Límites del monitor
`screen_capture`	Captura de pantalla (devuelve MCP ImageContent)
`screen_capture_save`	Capturar y guardar en archivo
`screen_get_pixel_color`	Color de píxel en coordenadas
`screen_get_mouse_color`	Color de píxel bajo el cursor

Gestión de ventanas (9 herramientas)

Herramienta	Descripción
`window_get_active`	Información de la ventana activa
`window_get_title`	Título de la ventana
`window_get_bounds`	Límites de la ventana
`window_set_active`	Activar ventana
`window_move`	Mover ventana
`window_resize`	Cambiar tamaño de ventana
`window_minimize`	Minimizar ventana
`window_maximize`	Maximizar ventana
`window_close`	Cerrar ventana

Gestión de procesos (6 herramientas)

Herramienta	Descripción
`process_list`	Listar todos los procesos
`process_find_by_name`	Buscar procesos por nombre
`process_get_name`	Obtener nombre de proceso por PID
`process_exists`	Comprobar si existe el proceso
`process_kill`	Matar proceso
`process_run`	Ejecutar comando

Utilidades del sistema (3 herramientas)

Herramienta	Descripción
`system_get_info`	Información del sistema
`util_sleep`	Suspender/retrasar
`alert_show`	Mostrar cuadro de diálogo

Ejemplos de uso

Mover el ratón y hacer clic

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

Escribir texto

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

Teclas de acceso rápido

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

Captura de pantalla

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

Teclas admitidas

Letras y números

a-z, A-Z, 0-9

Teclas de función

f1-f24

Navegación

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

Teclas especiales

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

Modificadores

alt, ctrl, shift, cmd (o command)

Multimedia

audio_mute, audio_vol_down, audio_vol_up, audio_play, audio_stop, audio_pause

Licencia

MIT