go_computer_use_mcp_server

WARNING

このサーバーは信頼されたローカルMCPツールとして実行することを意図しています。現在、広範なローカルデスクトップ制御を提供しており、デフォルトではサンドボックス化されていません。追加のセキュリティ制御なしに、信頼できないネットワーク、ユーザー、またはエージェントに公開しないでください。

コンピュータ自動化のためのGo言語製MCP (Model Context Protocol) サーバー。デスクトップ自動化に robotgo ライブラリを使用します。

機能

マウス制御: 移動、クリック、ドラッグ、スクロール
キーボード制御: キー入力、テキスト入力、ホットキー
画面操作: スクリーンショット、ピクセル色取得、ディスプレイ情報
ウィンドウ管理: 移動、リサイズ、最小化/最大化
プロセス管理: プロセス一覧、検索、終了
システムユーティリティ: システム情報、ダイアログ、遅延

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

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サーバーアイコンをクリックし、「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

特殊キー

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