LLMAPI MCP Supervisor

2.0.3 verified Fri May 01 auth: no javascript

An MCP server for Claude Code that provides project analysis tools including project map, lint checking, test execution, dependency graph, and code quality reporting. Version 2.0.3 supports multiple languages (Node.js, Python, Rust, Go) with auto-detection of linters, type checkers, and test runners. Published on npm as @llmapi/mcp-supervisor, it requires Node.js >= 18 and Git. The server runs locally and can optionally sync with llmapi.pro proxy layer.

Common errors

error Error: Cannot find module '@llmapi/mcp-supervisor' ↓

cause Using require() incorrectly or missing npx- y

fix

Run via npx -y @llmapi/mcp-supervisor instead of direct require

error Error: tools.tool not found: session_sync ↓

cause Missing API key for proxy sync

fix

Set LLMAPI_API_KEY environment variable or add sync.apiKey to .llmapi-mcp.json

error git: command not found ↓

cause Git not installed or not in PATH

fix

Install Git and ensure it's available in your shell

error Config file .mcp-supervisor.json ignored ↓

cause Old config file name; v2 uses .llmapi-mcp.json

fix

Rename to .llmapi-mcp.json and update keys as per documentation

Warnings

gotcha Claude Code auto-detection may not pick up custom linter/test configurations; override via .llmapi-mcp.json ↓

fix Create .llmapi-mcp.json in project root with explicit linter/test commands

breaking Version 2.0.0 changed configuration file format from .mcp-supervisor.json to .llmapi-mcp.json ↓

fix Rename .mcp-supervisor.json to .llmapi-mcp.json and update keys

deprecated Global install (npm install -g) is deprecated in favor of npx usage ↓

fix Use npx -y @llmapi/mcp-supervisor in Claude Code settings

gotcha Requires Node.js 18 or later; older versions cause startup failure ↓

fix Ensure Node.js >= 18.0.0

gotcha Git is required for project_map caching, dep_graph, and quality_report tools ↓

fix Install Git and ensure it's in PATH

gotcha Proxy sync requires LLMAPI_API_KEY environment variable or sync.apiKey in .llmapi-mcp.json ↓

fix Set LLMAPI_API_KEY or add sync.apiKey to config

Install

npm install llmapi-mcp

yarn add llmapi-mcp

pnpm add llmapi-mcp

Imports

default
wrong
```
npm install -g @llmapi/mcp-supervisor (then run as command)
```
correct
```
npx -y @llmapi/mcp-supervisor
```
Recommended usage is via npx; global install is optional. The package is a CLI tool, not a library.

llmapi-mcp

wrong

using npx with @llmapi/mcp-supervisor (works but not recommended as global command)

correct

command: 'llmapi-mcp' (after global install)

The binary is named 'llmapi-mcp' after global install.

mcpServers
```
Add to Claude Code's settings.json under mcpServers
```
Configuration in Claude Code settings; no direct import in user code.

Quickstart

Configures Claude Code to use the MCP server, enabling tools like project_map, lint_check, run_tests.

// Add to ~/.claude/settings.json or project .claude/settings.json
{
  "mcpServers": {
    "llmapi": {
      "command": "npx",
      "args": ["-y", "@llmapi/mcp-supervisor"]
    }
  }
}