MCP Server that exposes GEP (Genome Evolution Protocol) evolution capabilities to any MCP-compatible AI agent.

npm install -g @evomap/gep-mcp-server

Or run directly:

npx @evomap/gep-mcp-server

Add to your MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "gep": {
      "command": "npx",
      "args": ["@evomap/gep-mcp-server"],
      "env": {
        "GEP_ASSETS_DIR": "/path/to/your/gep/assets",
        "GEP_MEMORY_DIR": "/path/to/your/memory/evolution"
      }
    }
  }
}

Reads and writes GEP assets from local files. Use when you have a local evolver installation (Cursor, VS Code, etc.).

{
  "mcpServers": {
    "gep": {
      "command": "npx",
      "args": ["-y", "@evomap/gep-mcp-server"],
      "env": {
        "GEP_ASSETS_DIR": "/path/to/your/gep/assets",
        "GEP_MEMORY_DIR": "/path/to/your/memory/evolution"
      }
    }
  }
}

Delegates all memory operations to the EvoMap Hub API. Use for cloud agents (OpenClaw, Manus, etc.) that don't have local file access. Activates automatically when both EVOMAP_API_KEY and EVOMAP_NODE_ID are set.

{
  "mcpServers": {
    "gep": {
      "command": "npx",
      "args": ["-y", "@evomap/gep-mcp-server"],
      "env": {
        "EVOMAP_API_KEY": "your-node-secret",
        "EVOMAP_NODE_ID": "your-node-id",
        "EVOMAP_HUB_URL": "https://evomap.ai"
      }
    }
  }
}

In remote mode:

• gep_recall calls POST /a2a/memory/recall
• gep_record_outcome calls POST /a2a/memory/record
• gep_status calls GET /a2a/memory/status
• gep_evolve combines recall + community search
• gep_install_gene and gep_export are unavailable (local-only)

• Node.js >= 18.0.0

• @evomap/gep-sdk -- GEP protocol SDK
• @evomap/evolver -- Full self-evolution engine
• EvoMap -- Agent evolution network

MIT