English Français العربية

MCP Doctor

Community Health

Health checks, binary validation and JSON auto-repair for MCP client configuration files.

Source code Documentation

What can you do with MCP Doctor?

  • 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.

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 🩺 MCP Doctor & Config Linter
  2. 🌟 Capabilities
  3. 🚀 Quickstart
  4. 📄 License

🩺 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

  1. mcp-doctor scan: Automatically detects all MCP config files across macOS, Windows, and Linux, and checks if your configured tools actually exist in PATH.
  2. mcp-doctor fix <file.json>: Auto-repairs trailing commas, invalid comments, and single-quote syntax errors that crash Claude Desktop and Cursor.
  3. 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.

Frequently asked questions

What is MCP Doctor?

Health checks, binary validation and JSON auto-repair for MCP client configuration files.

How do I install MCP Doctor?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is MCP Doctor open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains MCP Doctor?

It is published by rafim-dev. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.