{"id":25899,"library":"llmapi-mcp","title":"LLMAPI MCP Supervisor","description":"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.","status":"active","version":"2.0.3","language":"javascript","source_language":"en","source_url":"https://github.com/llmapi-pro/journal","tags":["javascript","model-context-protocol","mcp","llmapi","claude-code","claude","ai-coding","anthropic","typescript"],"install":[{"cmd":"npm install llmapi-mcp","lang":"bash","label":"npm"},{"cmd":"yarn add llmapi-mcp","lang":"bash","label":"yarn"},{"cmd":"pnpm add llmapi-mcp","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required for project_map caching, dep_graph reverse lookup, and quality_report commands","package":"git","optional":false}],"imports":[{"note":"Recommended usage is via npx; global install is optional. The package is a CLI tool, not a library.","wrong":"npm install -g @llmapi/mcp-supervisor (then run as command)","symbol":"default","correct":"npx -y @llmapi/mcp-supervisor"},{"note":"The binary is named 'llmapi-mcp' after global install.","wrong":"using npx with @llmapi/mcp-supervisor (works but not recommended as global command)","symbol":"llmapi-mcp","correct":"command: 'llmapi-mcp' (after global install)"},{"note":"Configuration in Claude Code settings; no direct import in user code.","symbol":"mcpServers","correct":"Add to Claude Code's settings.json under mcpServers"}],"quickstart":{"code":"// Add to ~/.claude/settings.json or project .claude/settings.json\n{\n  \"mcpServers\": {\n    \"llmapi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@llmapi/mcp-supervisor\"]\n    }\n  }\n}","lang":"javascript","description":"Configures Claude Code to use the MCP server, enabling tools like project_map, lint_check, run_tests."},"warnings":[{"fix":"Create .llmapi-mcp.json in project root with explicit linter/test commands","message":"Claude Code auto-detection may not pick up custom linter/test configurations; override via .llmapi-mcp.json","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Rename .mcp-supervisor.json to .llmapi-mcp.json and update keys","message":"Version 2.0.0 changed configuration file format from .mcp-supervisor.json to .llmapi-mcp.json","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Use npx -y @llmapi/mcp-supervisor in Claude Code settings","message":"Global install (npm install -g) is deprecated in favor of npx usage","severity":"deprecated","affected_versions":">=2.0.0"},{"fix":"Ensure Node.js >= 18.0.0","message":"Requires Node.js 18 or later; older versions cause startup failure","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Install Git and ensure it's in PATH","message":"Git is required for project_map caching, dep_graph, and quality_report tools","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Set LLMAPI_API_KEY or add sync.apiKey to config","message":"Proxy sync requires LLMAPI_API_KEY environment variable or sync.apiKey in .llmapi-mcp.json","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run via npx -y @llmapi/mcp-supervisor instead of direct require","cause":"Using require() incorrectly or missing npx- y","error":"Error: Cannot find module '@llmapi/mcp-supervisor'"},{"fix":"Set LLMAPI_API_KEY environment variable or add sync.apiKey to .llmapi-mcp.json","cause":"Missing API key for proxy sync","error":"Error: tools.tool not found: session_sync"},{"fix":"Install Git and ensure it's available in your shell","cause":"Git not installed or not in PATH","error":"git: command not found"},{"fix":"Rename to .llmapi-mcp.json and update keys as per documentation","cause":"Old config file name; v2 uses .llmapi-mcp.json","error":"Config file .mcp-supervisor.json ignored"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}