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 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