MCP Setup

Configure required MCP servers for agent-harness token efficiency and learning loops.

Required MCP Servers

Server	Purpose	API Key
token-efficient	CSV/log processing, sandbox execution (98% token savings)	None
context-graph	Semantic decision trace search	Voyage AI

Setup Instructions

Quick setup - Run scripts/setup-all.sh in your project directory:

cd /path/to/your/project
bash ~/.claude/skills/mcp-setup/scripts/setup-all.sh

This will:

1. Create mcp/ folder in your project
2. Clone and build token-efficient MCP
3. Clone and install context-graph MCP
4. Prompt for Voyage AI API key
5. Generate .mcp.json in project root

---

Manual setup (if needed):

1. Install token-efficient MCP in mcp/

mkdir -p mcp
git clone https://github.com/gurusharan/token-efficient-mcp.git mcp/token-efficient-mcp
cd mcp/token-efficient-mcp
npm install
npm run build

2. Install context-graph MCP in mcp/

git clone https://github.com/gurusharan/agent-harness.git mcp/context-graph-mcp
cd mcp/context-graph-mcp/context-graph-mcp  # or just mcp/context-graph-mcp
pip install -r requirements.txt

3. Create .mcp.json in project root

{
  "mcpServers": {
    "token-efficient": {
      "command": "node",
      "args": ["mcp/token-efficient-mcp/dist/index.js"]
    },
    "context-graph": {
      "command": "uv",
      "args": ["--directory", "mcp/context-graph-mcp", "run", "python", "server.py"],
      "env": {
        "VOYAGE_API_KEY": "your_key_here"
      }
    }
  }
}

4. Restart Claude Code

After setup, restart Claude Code to load MCP servers.

Verification

After setup, test:

# Via context-graph MCP
context_store_trace(decision="Test setup", category="general")
context_list_categories()

Troubleshooting

Issue	Solution
module 'chromadb' not found	pip install chromadb
VOYAGE_API_KEY not found	Set env var or add to mcp.json env
Tools not available	Restart Claude Code
srt: command not found	Install token-efficient MCP

Scripts

Script	Purpose
scripts/setup-all.sh	Use this - Auto-detects paths, sets up both MCP servers
scripts/verify-setup.sh	Check if MCP servers are working
scripts/install-token-efficient.sh	Standalone token-efficient MCP installer