Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

37 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🩺 MCP Doctor

Scan Β· Score Β· Install β€” Your MCP Server Toolkit

GitHub Stars CI PyPI PyPI Downloads License: MIT Python 3.10+ Security Scanner MCP Compatible

The missing security and quality toolkit for the Model Context Protocol ecosystem. Scan MCP servers for vulnerabilities, score their quality, compare alternatives, and install with confidence.

By the Numbers

πŸ“¦ Registry πŸ”’ Security Checks πŸ“Š Quality Dimensions
100+ servers scored 10 detection engines 5 scoring categories

πŸ€” Why MCP Doctor?

The MCP ecosystem is exploding β€” hundreds of servers, but no way to know which ones are safe, well-maintained, or even work. MCP Doctor is your one-stop CLI to navigate the MCP jungle.

Before installing an MCP server, run it through the Doctor.

The MCP Security Crisis

In the first 6 months of 2026, security researchers filed 30+ CVEs targeting MCP servers, clients, and infrastructure:

  • CVE-2026-44717 β€” eval() RCE in mcp_calculate_server (CVSS 9.8)
  • CVE-2026-49257 β€” Default no-auth + 0.0.0.0 binding in mcp-pinot (CVSS 10.0)
  • CVE-2026-46519 β€” Access control bypass in mcp-server-kubernetes (presentation-layer only filtering)
  • CVE-2026-32814 β€” MCP SDK authentication bypass, 3 Indian AI startups compromised
  • CVE-2026-25536 β€” Concurrent session data leakage in mcp-handler (Vercel)

A study of 39,884 open-source MCP servers found 106 zero-day vulnerabilities. OX Security found that 82% of MCP implementations have path traversal vulnerabilities.

MCP Doctor catches these before you deploy them.

MCP Doctor vs Other Tools

Feature MCP Doctor Cisco mcp-scanner Snyk Agent Scan Oxvault mcp-shield mcpsec
Security scanning βœ… 10 engines βœ… YARA+LLM+API βœ… LLM+guardrails βœ… SAST+runtime βœ… 20 rules βœ… fuzzer
Quality scoring (0-100) βœ… ❌ ❌ ❌ βœ… (A-F) ❌
Curated registry (100+) βœ… ❌ ❌ ❌ ❌ ❌
Server comparison βœ… ❌ ❌ ❌ ❌ ❌
One-command install βœ… ❌ ❌ ❌ ❌ ❌
CI/CD integration βœ… βœ… βœ… βœ… (SARIF) ❌ ❌
Runtime proxy mode ❌ ❌ βœ… ❌ ❌ ❌
REST API server ❌ βœ… ❌ ❌ ❌ ❌
Local / no API dependency βœ… βœ… ❌ (needs token) βœ… βœ… βœ…
SARIF output ❌ ❌ ❌ βœ… ❌ ❌

How MCP Doctor fits: Cisco mcp-scanner and Snyk Agent Scan are excellent for auditing existing deployments. Oxvault is best for deep SAST of MCP source code. MCP Doctor is for the pre-install workflow β€” discover, compare, and install servers with confidence. Most teams need both: a scanner for what's deployed and a discovery tool for what to deploy next.

✨ Features

  • πŸ”’ Security Scan β€” 8 detection engines: prompt injection, path traversal, credential leakage, network exfiltration, command injection, SSRF, supply chain, and excessive permissions
  • πŸ“Š Quality Score β€” Automated 0-100 scoring based on: security, maintenance, documentation, testing, community
  • βš–οΈ Compare β€” Side-by-side comparison of two MCP servers across all quality dimensions
  • πŸ“¦ Registry β€” Curated database of 100+ popular MCP servers with pre-computed scores and categories
  • ⚑ Quick Install β€” mcp-doctor install <server> β€” one command to scan + score + install
  • 🩺 CI/CD Audit β€” mcp-doctor audit <server> β€” full report with exit codes for pipelines
  • πŸ“ˆ Stats β€” Registry overview with category breakdowns and averages

πŸš€ Quick Start

# Install
pip install mcpdoctor-cli

# Or install directly from GitHub (if PyPI not yet available)
pip install git+https://github.com/xlyoung/mcp-doctor

# Scan an MCP server for security issues
mcp-doctor scan @modelcontextprotocol/server-filesystem

# Score a server's quality (0-100)
mcp-doctor score modelcontextprotocol/servers

# Compare two servers side-by-side
mcp-doctor compare @modelcontextprotocol/server-postgres mcp-server-mysql

# See top-rated servers by category
mcp-doctor list --category database --sort score

# Install with confidence (blocks on critical security issues)
mcp-doctor install @modelcontextprotocol/server-github

# Full audit for CI/CD (exits non-zero on failure)
mcp-doctor audit @modelcontextprotocol/server-filesystem --threshold 60
mcp-doctor audit @modelcontextprotocol/server-filesystem --json  # machine-readable

# View registry stats
mcp-doctor stats

πŸ”¬ Demo: Scan in Action

$ mcp-doctor scan @modelcontextprotocol/server-filesystem

🩺 MCP Doctor β€” Security Scan
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Target: @modelcontextprotocol/server-filesystem

πŸ”’ Security Issues Found: 3
   β”œβ”€β”€ 🟠 MEDIUM  Unconstrained Parameters
   β”‚   └── 6 string params lack maxLength/pattern constraints
   β”‚       β†’ path (read_file, write_file, edit_file, ...)
   β”œβ”€β”€ 🟑 LOW     Excessive Permissions
   β”‚   └── Configurable access control but no default restrictions
   └── 🟑 LOW     No Input Sanitization
       └── Path parameters accept ../ traversal sequences

⚠️  Security Score: 72/100 (Fair)

Use --json for machine-readable output
Use --threshold 80 to enforce minimum score in CI/CD

πŸ“Š Quality Score Breakdown

Each MCP server receives a score from 0-100:

Category Weight What it checks
Security 35% Prompt injection, path traversal, network safety
Maintenance 25% Commit frequency, issue response time, release cadence
Documentation 15% README quality, API docs, examples
Testing 15% Test coverage, CI status, integration tests
Community 10% Stars, contributors, ecosystem integrations

πŸ”’ Security Checks

MCP Doctor scans for common MCP vulnerability patterns:

  • Prompt Injection β€” User input flowing directly into LLM prompts without sanitization
  • Path Traversal β€” File system tools accepting ../ in paths without validation
  • Credential Leakage β€” API keys, tokens, or secrets exposed in logs or responses
  • Network Exfiltration β€” Suspicious external endpoints (webhook.site, ngrok tunnels)
  • Supply Chain β€” Typosquatting, abandoned dependencies, known CVEs
  • SSRF β€” Server-side request forgery via unvalidated URL parameters
  • Command Injection β€” Shell command execution with unsanitized input
  • Excessive Permissions β€” Auth bypass flags, unrestricted filesystem globs, world-readable permissions
  • Unconstrained Parameters β€” String params without maxLength/pattern/enum (DoS + injection chain risk)
  • Tool Access Control Bypass β€” Presentation-layer filtering without execution-layer enforcement (CVE-2026-46519 pattern)

βš–οΈ Compare Servers

Can't decide between two MCP servers? Compare them:

$ mcp-doctor compare @modelcontextprotocol/server-postgres mcp-server-mysql

           MCP Server Comparison
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━┓
┃ Metric           ┃ postgres  ┃ mysql     ┃
┑━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━┩
β”‚ Overall Score    β”‚   90/100  β”‚   78/100  β”‚
β”‚ Security         β”‚    90     β”‚    80     β”‚
β”‚ Maintenance      β”‚    95     β”‚    60     β”‚
β”‚ Documentation    β”‚    70     β”‚    50     β”‚
β”‚ Testing          β”‚    55     β”‚    50     β”‚
β”‚ Community        β”‚    95     β”‚    80     β”‚
β”‚ Security Issues  β”‚    0      β”‚    0      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

βœ” Recommendation: @modelcontextprotocol/server-postgres (score 90 vs 78)

πŸ“– MCP Server Registry

Browse the full registry: REGISTRY.md

Categories:

  • πŸ—„οΈ Database β€” PostgreSQL, MySQL, SQLite, Redis, MongoDB, Qdrant, ClickHouse, Supabase, Neon, Google Toolbox
  • πŸ“ File System β€” Local files, S3
  • 🌐 Web β€” Brave Search, Playwright, Puppeteer, Firecrawl, Chrome MCP, BrowserMCP, bb-browser
  • πŸ”§ DevOps β€” GitHub (official & MCP), GitLab, Docker, Kubernetes, Git, XcodeBuild
  • πŸ’¬ Communication β€” Slack, Discord, Gmail, Telegram, WhatsApp
  • 🧠 Knowledge β€” Notion, Obsidian, Memory, Confluence
  • πŸ€– AI/ML β€” FastMCP, Hugging Face, Replicate, Ollama
  • πŸ”’ Security β€” Semgrep, NVD CVE, GhidraMCP, MCP Audit, MCPSec, HexStrike AI
  • 🎨 Design β€” Figma Context MCP
  • πŸ“‹ Productivity β€” Google Maps, Linear, Airtable, Google Calendar, Todoist, Kreuzberg
  • πŸ–₯️ System β€” DesktopCommanderMCP, Windows-MCP
  • πŸ› οΈ Developer Tools β€” MCP Inspector, git-mcp, MCP Registry
  • ☁️ Cloud β€” AWS (awslabs), ActivePieces
  • πŸ—οΈ Framework β€” mcp-use
  • πŸ”„ Automation β€” ActivePieces

πŸ› οΈ Development

git clone https://github.com/xlyoung/mcp-doctor.git
cd mcp-doctor
pip install -e ".[dev]"
pytest

🀝 Contributing

Found an MCP server that should be in the registry? Open an issue or submit a PR!

See CONTRIBUTING.md for guidelines.

πŸ” Security

Found a security vulnerability? See SECURITY.md for responsible disclosure guidelines.

πŸ“œ Changelog

See CHANGELOG.md for release history.

πŸ“„ License

MIT β€” do whatever you want with it.


Built for the MCP community. Star ⭐ if you find it useful!

About

Scan, Score, Install MCP Servers with confidence. The missing toolkit for the MCP ecosystem.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages