🩺 MCP Doctor & Config Linter
The Essential Health Check, Stdio Diagnoser & Auto-Repair Engine for Model Context Protocol (MCP).
Diagnoses broken configurations, validates stdio binaries, tests environment variables, and auto-fixes malformed JSON in Claude Desktop, Cursor, and Cline.
🌟 Capabilities
mcp-doctor scan: Automatically detects all MCP config files across macOS, Windows, and Linux, and checks if your configured tools actually exist in PATH.mcp-doctor fix <file.json>: Auto-repairs trailing commas, invalid comments, and single-quote syntax errors that crash Claude Desktop and Cursor.- MCP Stdio Server Mode: Allows your AI assistant to self-diagnose and repair other MCP servers directly inside the chat.
🚀 Quickstart
# Standalone execution
node dist/index.js scan
# Auto-repair a broken MCP config
node dist/index.js fix ~/.config/Claude/claude_desktop_config.json
📄 License
MIT License. Created by Project GOAT.