@llmapi/mcp-supervisor

MCP server for Claude Code — provides project analysis tools that run locally on your machine.

Tools

| Tool | Description | |------|-------------| | project_map | Project structure map: directory tree, key files, recent changes, language stats | | file_context | Compressed file summary: function/class signatures. Saves 70-90% tokens vs full read | | lint_check | Run linter + type-checker on changed files. Auto-detects ESLint, tsc, ruff, cargo clippy | | run_tests | Smart test execution: finds tests related to changed files. Supports Jest, Vitest, pytest | | dep_graph | Import/dependency graph: what a file imports and what imports it | | quality_report | Code quality metrics: diff stats, file breakdown, lint summary | | session_sync | Sync local context with llmapi.pro proxy layer (requires API key) |

Quick Start

Claude Code (recommended)

Add to your Claude Code MCP settings (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "llmapi": {
      "command": "npx",
      "args": ["-y", "@llmapi/mcp-supervisor"]
    }
  }
}

Global Install

npm install -g @llmapi/mcp-supervisor

Then add to Claude Code settings:

{
  "mcpServers": {
    "llmapi": {
      "command": "llmapi-mcp"
    }
  }
}

Auto-Detection

The server automatically detects your project type and available tools:

| Project | Detected from | Linter | Type Checker | Test Runner | |---------|--------------|--------|--------------|-------------| | Node.js | package.json | ESLint / Biome | tsc | Jest / Vitest / Mocha | | Python | pyproject.toml | ruff / flake8 | mypy | pytest | | Rust | Cargo.toml | cargo clippy | cargo check | cargo test | | Go | go.mod | go vet | — | go test |

Override auto-detection by creating .llmapi-mcp.json in your project root:

{
  "linter": { "command": "npm", "args": ["run", "lint:custom"] },
  "testRunner": { "command": "npm", "args": ["run", "test:unit"] }
}

Requirements

• Node.js >= 18
• Git (for project_map caching, dep_graph reverse lookup, quality_report)

Proxy Layer Sync

If you use llmapi.pro, configure your API key to enable cross-session data sync (flywheel rule pull, quality metrics push).

Either set an environment variable:

export LLMAPI_API_KEY=sk-relay-your-key

…or add sync.apiKey to .llmapi-mcp.json in your project root:

{
  "sync": {
    "apiKey": "sk-relay-your-key"
  }
}

Optional sync.baseUrl overrides the default https://llmapi.pro/api/mcp.

License

MIT