mcp-doctor

Diagnose, secure, and benchmark your MCP servers.

Zero-config CLI that auto-discovers MCP server configs across Claude Code, Cursor, VS Code, Windsurf, and Claude Desktop — then tests connections, flags security issues, and benchmarks latency in seconds.

MCP servers are becoming the backbone of AI-assisted development. But as you add more servers across more tools, things break silently:

- Servers go downand you don't notice until a tool call fails mid-conversation
- Secrets leak— API keys hardcoded in config files, tokens visible in process args
- Slow serversdrag down your entire AI workflow without you realizing it
- Configs driftbetween tools — what works in Cursor might be broken in Claude Desktop

mcp-doctor gives you a single command to check everything, across every tool, in seconds.

That's it. No config needed — it finds your servers automatically.

All commands support--jsonfor machine-readable output.

Runs scan, security, and bench in one go and prints a summary.

mcp-doctor doctor # JSON output for CI/scripts mcp-doctor doctor --json

Discovers configs and verifies each server responds to a JSON-RPC handshake.

$ mcp-doctor scan ┌─────────────────────────────────────────┐ │ mcp-doctor v0.3.0 │ │ Diagnose · Secure · Benchmark │ └─────────────────────────────────────────┘ ✔ Found 3 server(s) ┌──────────────┬────────────┬─────────┐ │ Server │ Source │ Status │ ├──────────────┼────────────┼─────────┤ │ filesystem │ Claude │ ✔ OK │ │ postgres │ Cursor │ ✔ OK │ │ slack │ VS Code │ ✘ FAIL │ └──────────────┴────────────┴─────────┘

security— Audit configs for security issues

Checks for leaked secrets, overly broad permissions, and risky command patterns.

$ mcp-doctor security ⚠ 2 issues found ┌──────────┬──────────┬───────────────────────────────┐ │ Severity │ Server │ Issue │ ├──────────┼──────────┼───────────────────────────────┤ │ HIGH │ postgres │ Plaintext password in config │ │ MEDIUM │ slack │ Token visible in args │ └──────────┴──────────┴───────────────────────────────┘

Measures JSON-RPC round-trip latency for every configured server.

$ mcp-doctor bench ┌──────────────┬──────────┬────────┐ │ Server │ Latency │ Rating │ ├──────────────┼──────────┼────────┤ │ filesystem │ 12ms │ fast │ │ postgres │ 87ms │ ok │ │ slack │ timeout │ — │ └──────────────┴──────────┴────────┘

mcp-doctor can also runas an MCP server itself, exposingscan,security,bench, anddoctoras tools your AI assistant can call directly.

{ "mcpServers": { "mcp-doctor": { "command": "npx", "args": ["@wigu/mcp-doctor"] } } }

When invoked without arguments and stdin is piped, it automatically starts in server mode using stdio transport. You can also explicitly run:

This means your AI assistant can diagnose its own MCP infrastructure on demand.

Use mcp-doctor in CI to catch broken servers and leaked secrets automatically:

- name: Check MCP servers uses: realwigu/mcp-doctor@main with: command: doctor fail-on-error: "true"

The action outputs JSON via${{ steps.mcp-doctor.outputs.result }}for downstream processing.

All commands support--jsonfor structured output — useful for CI pipelines, dashboards, or scripting:

mcp-doctor doctor --json | jq '.summary'

{ "servers": 3, "healthy": 2, "securityIssues": 1, "avgLatencyMs": 45 }

mcp-doctor reads each tool's config file from its standard location and merges all discovered servers into a single view.

- Connection health— JSON-RPCinitializehandshake against every server
- Security issues— plaintext secrets, tokens in args, dangerous shell commands
- Latency benchmarks— round-trip timing with fast / ok / slow ratings

# Run directly (no install needed) npx @wigu/mcp-doctor scan # Or install globally npm install -g @wigu/mcp-doctor mcp-doctor scan

Contributions are welcome! Open an issue or submit a pull request.
- Fork the repo
- Create a feature branch (git checkout -b my-feature)
- Commit your changes
- Open a PR

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Create crafted UI components inspired by the best 21st.dev design engineers.

Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent

ALAPI MCP Tools,Call hundreds of API interfaces via MCP

AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform

MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.

APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.

One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB