mcp-doctor

mcp-doctor

Diagnostica, asegura y evalúa el rendimiento de tus servidores MCP.

CLI de configuración cero que detecta automáticamente las configuraciones de servidores MCP en Claude Code, Cursor, VS Code, Windsurf y Claude Desktop — luego prueba conexiones, señala problemas de seguridad y evalúa la latencia en segundos.

¿Por qué?

Los servidores MCP se están convirtiendo en la columna vertebral del desarrollo asistido por IA. Pero a medida que agregas más servidores en más herramientas, las cosas se rompen silenciosamente:

• Los servidores se caen y no te das cuenta hasta que una llamada de herramienta falla a mitad de conversación
• Filtración de secretos — claves de API codificadas en archivos de configuración, tokens visibles en argumentos de procesos
• Servidores lentos ralentizan todo tu flujo de trabajo de IA sin que te des cuenta
• Las configuraciones se desincronizan entre herramientas — lo que funciona en Cursor podría estar roto en Claude Desktop

mcp-doctor te da un solo comando para verificar todo, en todas las herramientas, en segundos.

Inicio Rápido

npx @wigu/mcp-doctor doctor

Eso es todo. No se necesita configuración — encuentra tus servidores automáticamente.

Comandos

Comando	Descripción
doctor	Ejecuta todas las verificaciones a la vez (escaneo + seguridad + benchmark)
scan	Prueba todas las conexiones de servidores MCP
security	Audita configuraciones en busca de problemas de seguridad
bench	Evalúa los tiempos de respuesta de los servidores
serve	Se ejecuta como servidor MCP (transporte stdio)

Todos los comandos admiten --json para salida legible por máquina.

doctor — Chequeo completo (recomendado)

Ejecuta escaneo, seguridad y benchmark de una sola vez e imprime un resumen.

mcp-doctor doctor

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

scan — Prueba todas las conexiones de servidores MCP

Detecta configuraciones y verifica que cada servidor responda a un handshake JSON-RPC.

$ 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 — Audita configuraciones en busca de problemas de seguridad

Verifica secretos filtrados, permisos demasiado amplios y patrones de comandos riesgosos.

$ mcp-doctor security

  ⚠  2 issues found

  ┌──────────┬──────────┬───────────────────────────────┐
  │ Severity │ Server   │ Issue                         │
  ├──────────┼──────────┼───────────────────────────────┤
  │ HIGH     │ postgres │ Plaintext password in config  │
  │ MEDIUM   │ slack    │ Token visible in args         │
  └──────────┴──────────┴───────────────────────────────┘

bench — Evalúa los tiempos de respuesta de los servidores

Mide la latencia de ida y vuelta JSON-RPC para cada servidor configurado.

$ mcp-doctor bench

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

Modo Servidor MCP

mcp-doctor también puede ejecutarse como un servidor MCP en sí mismo, exponiendo scan, security, bench y doctor como herramientas que tu asistente de IA puede llamar directamente.

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

Cuando se invoca sin argumentos y stdin está canalizado, se inicia automáticamente en modo servidor usando transporte stdio. También puedes ejecutarlo explícitamente:

mcp-doctor serve

Esto significa que tu asistente de IA puede diagnosticar su propia infraestructura MCP bajo demanda.

Acción de GitHub

Usa mcp-doctor en CI para detectar servidores rotos y secretos filtrados automáticamente:

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

La acción genera JSON a través de ${{ steps.mcp-doctor.outputs.result }} para procesamiento posterior.

Salida JSON

Todos los comandos admiten --json para salida estructurada — útil para pipelines de CI, paneles o scripting:

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

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

Herramientas Compatibles

Herramienta	Config. Auto-Detectada
Claude Code	✅
Claude Desktop	✅
Cursor	✅
VS Code	✅
Windsurf	✅

mcp-doctor lee el archivo de configuración de cada herramienta desde su ubicación estándar y combina todos los servidores detectados en una vista única.

Qué Verifica

• Salud de la conexión — handshake JSON-RPC initialize contra cada servidor
• Problemas de seguridad — secretos en texto plano, tokens en argumentos, comandos de shell peligrosos
• Benchmarks de latencia — tiempo de ida y vuelta con calificaciones rápido / ok / lento

Instalación

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

# Or install globally
npm install -g @wigu/mcp-doctor
mcp-doctor scan

Requiere Node.js 18+.

Contribuciones

¡Las contribuciones son bienvenidas! Abre un issue o envía un pull request.

1. Haz fork del repositorio
2. Crea una rama de características (git checkout -b my-feature)
3. Haz commit de tus cambios
4. Abre un PR

Licencia

MIT