eac-mcp-server

The eac-mcp-server module provides Model Context Protocol (MCP) server integration for AI assistants like Claude.

It exposes EAC commands as MCP tools that can be discovered and invoked by AI agents.

System Context

Shows how eac-mcp-server bridges AI assistants with the EAC system.

Container Architecture

High-level view of the MCP server components.

Component Architecture

Internal structure of the MCP command system.

Workflow Diagrams

Tool Discovery

How AI assistants discover available EAC commands.

Tool Call

The flow when an AI assistant invokes an EAC command.

Design File

Location: specs/eac-mcp-server/.design/workspace.dsl
Interactive: eac serve design --module eac-mcp-server

MCP Integration

The MCP server enables AI assistants to:

Discover available EAC commands dynamically
Invoke commands with proper argument handling
Receive structured responses for further processing
Access repository state and build information

Configuration

Production Configuration (Default)

MCP server is configured in Claude Code settings (.mcp.json):

{
  "mcpServers": {
    "commands": {
      "command": "mcp-server"
    }
  }
}

Uses eac <command> by default (Docker-based execution).

Development Configuration (Local Override)

For local development with faster startup (.mcp.json):

{
  "mcpServers": {
    "commands": {
      "command": "go",
      "args": ["run", "./go/mcp/commands/main.go"],
      "env": {
        "EAC_USE_DIRECT_BINARY": "true"
      }
    }
  }
}

Uses direct binary execution (faster, ~100ms startup vs ~2s Docker).

Environment Variable

EAC_USE_DIRECT_BINARY:

true: Forces direct binary execution (development)
Not set or false: Uses eac (production, default)

Verification

# Test production mode
echo '{"jsonrpc":"2.0","id":1,"method":"initialize"}' | eac mcp commands

# Test development mode
EAC_USE_DIRECT_BINARY=true go run ./go/mcp/commands/main.go < input.json

Tutorials | How-to Guides | Explanation | Reference

You are here: Reference — information-oriented technical descriptions of the system.