trace-mcp

Overview ¶

Package main implements the Aleutian Trace MCP server.

Description:

This binary exposes all trace tools via the Model Context Protocol (MCP)
over stdio. It is designed to be used as an MCP server by Claude Code,
Cursor, Windsurf, and other MCP-compatible AI assistants.

The server delegates all tool calls to the Trace service via the ToolBridge
HTTP client, which handles graph_id management, parameter mapping, and
result truncation.

Usage:

trace-mcp [flags]
  -trace-url string  Trace service URL (default: ALEUTIAN_TRACE_URL env or http://localhost:12217)

Example Claude Code config (.claude/mcp.json):

{
  "mcpServers": {
    "aleutian-trace": {
      "command": "trace-mcp",
      "args": ["-trace-url", "http://localhost:12217"]
    }
  }
}