Documentation
¶
Overview ¶
Command gomotemcp is a Model Context Protocol (MCP) server that bridges an autonomous coding agent to the Go project's gomote remote build-and-test service. It lets an agent provision a buildlet for a target GOOS/GOARCH, sync a Go checkout, run package tests and arbitrary commands, inspect and download artifacts, and tear the instance down again — the full loop needed to reproduce and triage an upstream Go failure on real hardware.
It is built on the official MCP Go SDK (github.com/modelcontextprotocol/go-sdk) and speaks JSON-RPC 2.0 over stdio. All gomote interaction goes through the argc.dev/goexp/gomotecli package, which never invokes a shell.
Diagnostics are written to stderr; stdout is reserved for the protocol.
Configuration via environment variables:
GOMOTE_MCP_DOWNLOAD_DIR directory downloads are confined to
(default: ./gomote-downloads)
GOMOTE_MCP_UPLOAD_DIR directory uploads are sourced from, confined
(default: ./gomote-uploads)
GOMOTE_MCP_ALLOWED_BUILDERS comma-separated builder-type allowlist
(default: any well-formed builder type)
GOMOTE_MCP_MAX_INSTANCES max concurrent instances this server may hold
(default: 8; 0 disables creation)
GOMOTE_MCP_RUN_TIMEOUT per-tool-call timeout, e.g. "10m"
(default: 5m)
GOMOTE_MCP_SERVER override the gomote coordinator address
(default: gomote's built-in default)