algo-coach-mcp

Interactive algorithm coach MCP server with 3000+ LeetCode problems, bilingual descriptions (Chinese/English), local code testing, and real-world engineering case mapping.

Features

• 3000+ Problems — Full LeetCode free problem database with bilingual descriptions

• 12 Topic Categories — Array, Linked List, Hash Table, String, Two Pointers, Stack/Queue, Binary Tree, Backtracking, Greedy, DP, Monotonic Stack, Graph

• Local Code Execution — Run and test your Python solutions locally, no online judge needed

• Progressive Hints — 4-level hint system: direction -> approach -> pseudocode -> full solution

• Real-World Cases — See how algorithms apply in production systems (Redis, Kafka, React, etc.)

• 3 Practice Modes — Student (guided), Interview (timed), Engineering (system design focus)

• LeetCode Sync — Built-in script to fetch and update problems from LeetCode API

Related MCP server: Swarm Orchestrator

Quick Start

Use with Claude Code (Recommended)

One command setup — no local installation needed:

claude mcp add --transport stdio algo-coach -- npx -y --registry https://registry.npmjs.org/ algo-coach-mcp@latest

Restart Claude Code, then start practicing.

Use with other MCP clients

Add to your MCP configuration:

{
  "mcpServers": {
    "algo-coach": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "--registry", "https://registry.npmjs.org/", "algo-coach-mcp@latest"]
    }
  }
}

Available MCP Tools

Topics

LeetCode Sync

Fetch all free problems from LeetCode with bilingual descriptions:

npm run sync                  # Full sync (~3000 problems, ~50 min)
npm run sync -- --limit 100   # Sync first 100 problems
npm run sync:resume           # Resume interrupted sync

Features: checkpoint/resume, rate limiting (2 req/s), retry logic, bilingual (CN + EN).

Development

npm install
npm run dev        # Run with tsx (hot reload)
npm run sync       # Sync problems from LeetCode
npm run build      # Build for production
npm test           # Run tests

Architecture

src/
├── index.ts           # MCP server entry (stdio transport)
├── paths.ts           # Package root resolution
├── types.ts           # Shared type definitions
├── content/           # Content indexing and parsing
├── sync/              # LeetCode API sync pipeline
├── testgen/           # Test case generation
├── executor/          # Python subprocess runner
├── cases/             # Real-world case loader
├── tools/             # MCP tool implementations
└── resources/         # MCP resource handlers

License

MIT