Power your agent
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
uvx mcp-doctor==0.1.0Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
claude mcp add io.github.jiansen-mcp-doctor -- uvx mcp-doctor==0.1.0Run in a terminal.
{ "mcpServers": { "io.github.jiansen-mcp-doctor": { "command": "uvx", "args": [ "mcp-doctor==0.1.0" ] } }}claude_desktop_config.json
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
Most MCP servers are built with only one audience in mind (usually human developers reading a README). But a successful MCP server needs to satisfy three audiences simultaneously:
Check and improve the contract quality of any MCP server — for humans, agents, and platforms.
MCP Doctor checks all six dimensions of "contract quality" and gives you actionable recommendations.
pip install mcp-doctor
mcp-doctor check /path/to/your-mcp-server
# Terminal output (default, rule-based)
mcp-doctor check /path/to/server
# JSON output (for CI/CD)
mcp-doctor check /path/to/server --format json
# Markdown output (for README badges or reports)
mcp-doctor check /path/to/server --format markdown
# AI-enhanced evaluation (requires OPENAI_API_KEY)
mcp-doctor check /path/to/server --mode ai
# AI mode with a specific model
mcp-doctor check /path/to/server --mode ai --model gpt-4o
MCP Doctor is also an MCP server, so AI agents can use it to check other servers:
{
"mcpServers": {
"mcp-doctor": {
"command": "python",
"args": ["-m", "mcp_doctor.mcp_server"]
}
}
}
Tools:
check_server(path, format, mode, model) — Run all 6 checks. Use mode="ai" for LLM-enhanced review.list_dimensions() — List what MCP Doctor evaluatesOne-liner (paste this to your AI agent):
Install mcp-doctor (
pip install mcp-doctor) and add it to your MCP config with commandpython -m mcp_doctor.mcp_server. Then use thecheck_servertool to check any MCP server's quality.
Step by step:
pip install mcp-doctor{
"mcpServers": {
"mcp-doctor": {
"command": "python",
"args": ["-m", "mcp_doctor.mcp_server"]
}
}
}
check_server tool with a path to any MCP server repomcp-doctor check /path/to/server --format jsonAgent workflow: check server -> review scores -> identify lowest dimensions -> follow recommendations
Each dimension is scored 0-100 and graded A/B/C/D:
MCP Doctor is based on the Contract Quality Framework — the principle that a successful MCP product's promises (what it does, what it costs, what risks it carries) should be equally parseable by platforms, humans, and agents.
The framework draws from:
Rule-based mode is fully offline and deterministic. No network calls, no LLM, no API keys needed.
AI mode sends a metadata summary (server name, tool definitions, README preview, rule-based scores) to an OpenAI-compatible API for qualitative review. No source code is sent. Reports include model name and version for reproducibility.
AI mode supports any OpenAI-compatible provider:
OPENAI_API_KEY — API key (required for AI mode)OPENAI_BASE_URL — Custom endpoint (for Ollama, vLLM, LM Studio, Azure, etc.)MCP_DOCTOR_MODEL — Model name (default: gpt-4o-mini)Install AI support: pip install mcp-doctor[ai]
MCP Doctor is read-only. It never modifies, deletes, or creates files.
All MCP tools have readOnlyHint: true and destructiveHint: false annotations.
Found a bug? Have a suggestion? We'd love to hear from you:
gh CLI):
gh issue create --repo Jiansen/mcp-doctor --title "Bug: ..." --body "..."
If you're an agent, include the JSON output of check_server in your report for context.
git clone https://github.com/Jiansen/mcp-doctor.git
cd mcp-doctor
pip install -e ".[dev,ai]"
ruff check src/ tests/
pytest tests/ -v
If MCP Doctor helped you improve your server, consider giving it a star on GitHub — it helps others discover the tool.
MIT
© 2026 MCP Directory.
Check and improve the contract quality of any MCP server — for humans, agents, and platforms.
{ "mcpServers": { "io.github.jiansen-mcp-doctor": { "command": "uvx", "args": [ "mcp-doctor==0.1.0" ] } }}Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
MCP Doctor runs locally over stdio.
Last checked 2026-11-09. Check and improve the contract quality of any MCP server — for humans, agents, and platforms.