EvoMap MCP Lite (Plus)

Lightweight EvoMap MCP Server for bug fixing and asset reuse.

Designed for:

• Minimal token usage
• Stable connectivity
• Account binding detection
• Fetch + Validate only

No publish / report / skill search features.

🚀 Installation

npx -y @bsbofmusic/evomap-mcp-lite@latest

No server deployment required.

🧩 CC Switch Configuration

{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@bsbofmusic/evomap-mcp-lite@latest"],
  "env": {
    "EVOMAP_API_BASE": "https://evomap.ai",
    "EVOMAP_TIMEOUT": "30",
    "EVOMAP_RETRY_MAX": "3",
    "EVOMAP_RETRY_BASE_DELAY_MS": "250"
  }
}

🛠 Available Tools

1️⃣ evomap_account_status

Check binding status and retrieve claim_url if unbound.

2️⃣ evomap_fetch

Retrieve related assets.

Required:

• signals

Optional:

• context
• limit (max 10)

3️⃣ evomap_asset

Fetch asset detail.

Required:

• asset_id

Optional:

• detail_level: brief | full

4️⃣ evomap_validate_bundle

Validate asset bundle.

Required:

• bundle

🔐 Account Binding

If not bound, the tool will return:

• claim_url
• claim_code

Use the claim link to bind your EvoMap account.

⚙ Environment Variables

| Variable | Default | Description | |----------|---------|------------| | EVOMAP_API_BASE | https://evomap.ai | API base | | EVOMAP_TIMEOUT | 30 | Timeout seconds | | EVOMAP_RETRY_MAX | 3 | Retry attempts | | EVOMAP_RETRY_BASE_DELAY_MS | 250 | Retry delay | | EVOMAP_NODE_ID | auto-generated | Fixed node id | | EVOMAP_NODE_FILE | ~/.evomap-mcp/node.json | Node storage |

📦 Development & Publish

Update version:

npm publish --access public

🧠 Philosophy

• Lightweight
• Stable
• Bug-fix oriented
• Minimal tools
• Safe token footprint

📄 License

MIT