dr-mcp

Limpia y audita configuraciones desordenadas de MCP: servidores obsoletos, herramientas no utilizadas, MCPs con mucho contexto, paquetes desactualizados y planes de reparación seguros.

GitHubPrueba este MCPPatrocinado

Documentación

dr-mcp

Limpia tus MCPs.

dr-mcp es una herramienta local de auditoría y limpieza de MCPs para desarrolladores que usan codificación agéntica a diario. Escanea las configuraciones del Model Context Protocol que cargan tus herramientas, encuentra servidores obsoletos, paquetes abandonados, entradas duplicadas, herramientas que consumen mucho contexto, permisos riesgosos y actualizaciones importantes, y luego genera planes de parche reversibles.

Si usas Claude Code, OpenAI Codex, Cursor, Windsurf, GitHub Copilot, VS Code, Cline, Roo Code, Continue o Zed en múltiples proyectos, tu configuración de MCP puede crecer silenciosamente: servidores demo antiguos, herramientas de GitHub duplicadas, acceso amplio al sistema de archivos, fijaciones de paquetes detrás de npm latest, repositorios abandonados y superficies de herramientas grandes que tu agente debe considerar antes de escribir código.

dr-mcp muestra qué limpiar sin eliminar nada durante el escaneo.

npx @inferensys/dr-mcp cleanup

Eso inicia un escaneo de limpieza local en el proyecto actual. Obtienes un informe redactado, una lista clasificada de MCPs que consumen mucho contexto, señales de frescura de paquetes y repositorios, y planes de parche que puedes aplicar después de revisar.

Para el escaneo de limpieza completo con verificaciones de paquetes/repositorios y seguimiento del historial de instalación local:

npx @inferensys/dr-mcp cleanup --registry --track-usage

Dentro de Claude Code, Codex, Cursor, Windsurf, GitHub Copilot o cualquier cliente MCP que exponga prompts/herramientas de servidor, usa dr_mcp_scan o dr_mcp_cleanup. Si tu cliente asigna prompts de MCP a comandos de barra, usa /dr-mcp scan.

¿Por Qué Limpiar Tus MCPs?

Los servidores MCP son potentes porque ponen herramientas directamente en el bucle del agente. Eso también significa que cada servidor adicional puede agregar ruido en la selección de herramientas, presión en la ventana de contexto, fallos de inicio, dependencias obsoletas o permisos que ya no pretendes otorgar.

dr-mcp ayuda con:

Auditoría de MCP: un informe único en configuraciones de MCP globales y de proyecto.
Limpieza de MCP: revisa candidatos para duplicados, entradas muertas, paquetes abandonados, instalaciones de larga duración y superficies de herramientas pesadas.
Higiene de contexto de MCP: recuentos estimados de herramientas y peso de contexto para servidores que no pertenecen a cada sesión de codificación.
Revisión de seguridad de MCP: acceso amplio al sistema de archivos, secretos en línea, argumentos con apariencia de secreto y referencias de entorno rotas.
Planificación de actualizaciones de MCP: desviación de semver frente a npm latest, incluidas actualizaciones importantes que merecen revisión.
Planes de reparación de MCP: operaciones explícitas con copias de seguridad y diffs antes de escribir.

Qué Te Ayuda a Corregir

Recupera contexto. Ve qué MCPs agregan las listas de herramientas más grandes al prompt de tu agente.
Reduce llamadas de herramientas no deseadas. Elimina servidores antiguos que tu agente sigue considerando incluso cuando el proyecto no los necesita.
Abandona MCPs obsoletos. Con --registry, verifica metadatos de npm y actividad de GitHub para proyectos archivados o desactualizados.
Ve actualizaciones importantes. Encuentra paquetes de MCP fijados muy por detrás de npm latest y revisa planes de actualización.
Encuentra restos. Activa --track-usage y construye un registro local de MCPs que siguen apareciendo en los escaneos.
Elimina duplicados. Detecta el mismo MCP registrado en Claude, Cursor, VS Code, Codex, Windsurf o archivos de proyecto.
Corrige configuraciones riesgosas. Señala acceso amplio al sistema de archivos, secretos en línea, argumentos con apariencia de secreto, comandos faltantes, rutas muertas y referencias de entorno rotas.
Detén instalaciones flotantes. Detecta paquetes npx usando latest o sin versión.

Cómo Funciona la Auditoría

dr-mcp usa análisis estático práctico y verificaciones de metadatos de paquetes:

Descubre archivos de configuración para Claude Desktop, Claude Code, Codex, Cursor, Windsurf, GitHub Copilot, VS Code, Cline, Roo Code, Continue, Zed y .mcp.json.
Analiza y normaliza formas de configuración JSON, TOML y YAML en un modelo interno único de servidor MCP.
Puntúa la configuración en confiabilidad, seguridad, higiene de contexto y mantenibilidad.
Verifica la frescura de paquetes con metadatos de npm, clasificación semver, dist-tags.latest y coincidencia opcional con el registro oficial.
Estima el peso de contexto con heurísticas de cardinalidad de herramientas para MCPs de alta superficie como GitHub, automatización de navegador, Slack, Jira, sistema de archivos y bases de datos.
Revisa señales de mantenimiento desde el estado de archivo de GitHub y actividad reciente de envíos cuando los metadatos del repositorio están disponibles.
Genera planes de parche con objetivos JSON Pointer, operaciones idempotentes, copias de seguridad con marca de tiempo y diffs.

Comandos

# Local audit in the current project
npx @inferensys/dr-mcp

# Deeper cleanup report with package/repo checks and local install history
npx @inferensys/dr-mcp cleanup

# Full scan alias for agent workflows
npx @inferensys/dr-mcp scan --deep

# Local-only cleanup flow with no network checks or usage ledger writes
npx @inferensys/dr-mcp cleanup --local

# JSON for scripts or CI
npx @inferensys/dr-mcp scan --workspace . --json --registry

# Shareable cleanup report
npx @inferensys/dr-mcp report --workspace . --format html > dr-mcp-report.html

# Preview a repair plan
npx @inferensys/dr-mcp patch --workspace . --plan remove-duplicate-servers
npx @inferensys/dr-mcp patch --workspace . --plan upgrade-stale-packages

# Apply a reviewed repair plan with backups
npx @inferensys/dr-mcp patch --workspace . --plan remove-duplicate-servers --apply

# Run as an MCP server
npx @inferensys/dr-mcp server

Secciones del Informe

Puntuación: confiabilidad, seguridad, higiene de contexto, mantenibilidad.
Actualizaciones de paquetes: fijaciones de paquetes MCP detrás de npm latest, incluidas actualizaciones importantes.
Peso de contexto: MCPs clasificados por carga estimada de herramientas.
Historial de instalación: servidores de larga duración del registro de uso local.
Hallazgos: problemas concretos con rutas de configuración de origen.
Planes de parche: ediciones seguras como eliminar duplicados, entradas muertas, servidores abandonados o servidores que consumen mucho contexto.

Planes de Limpieza

dr-mcp separa los hallazgos de la acción. Un hallazgo te dice qué parece estar mal; un plan de parche te dice la edición de configuración exacta que puede hacer.

remove-duplicate-servers: elimina entradas de servidor MCP duplicadas manteniendo la primera definición habilitada.
remove-dead-servers: elimina entradas que no pueden iniciarse o paquetes faltantes en npm.
upgrade-stale-packages: actualiza referencias de paquetes MCP a npm latest.
remove-abandoned-servers: elimina servidores de repositorios archivados o abandonados.
remove-heavy-context-servers: elimina servidores que se estima cargan muchas herramientas en cada sesión.
remove-long-lived-servers: elimina servidores que han permanecido instalados en múltiples escaneos rastreados después de confirmar que ya no son útiles.

Herramientas Compatibles

Herramienta	Configuraciones escaneadas
Claude Desktop	`claude_desktop_config.json`
Claude Code / `cc`	`~/.claude.json`, `~/.claude/settings.json`, `.claude/settings.json`
OpenAI Codex	`~/.codex/config.toml`, `.codex/config.toml`
Cursor	`~/.cursor/mcp.json`, `.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`, `.windsurf/mcp.json`
GitHub Copilot en VS Code	Configuración de usuario de VS Code, configuración de usuario de VS Code Insiders, `.vscode/mcp.json`, `.vscode/settings.json`
GitHub Copilot CLI	`~/.copilot/mcp-config.json`, `.copilot/mcp-config.json`
Cline	`~/.cline/data/settings/cline_mcp_settings.json`, `.cline/data/settings/cline_mcp_settings.json`
Roo Code	`.roo/mcp.json`, rutas comunes de almacenamiento global de VS Code de Roo Code
Continue	`~/.continue/config.yaml`, `.continue/config.yaml`
Zed	Configuración de usuario de Zed, `.zed/settings.json`
MCP genérico	`.mcp.json`

Agrega dr-mcp a Tu Agente

Una vez agregado, comienza con la acción en sesión más corta:

dr_mcp_scan

Para candidatos de limpieza, actualizaciones, servidores abandonados e instalaciones de larga duración:

dr_mcp_cleanup

Los clientes que exponen prompts de MCP como comandos de barra pueden mostrarlos como dr_mcp_scan, dr_mcp_cleanup o un prompt como /dr-mcp scan.

Codex

codex mcp add dr-mcp -- npx -y @inferensys/dr-mcp server

Claude Code

claude mcp add dr-mcp -- npx -y @inferensys/dr-mcp server

Clientes de configuración JSON

Usa esto para Claude Desktop, Cursor, Windsurf, Cline, Roo Code, VS Code y GitHub Copilot en VS Code:

{
  "mcpServers": {
    "dr-mcp": {
      "command": "npx",
      "args": ["-y", "@inferensys/dr-mcp", "server"]
    }
  }
}

VS Code y GitHub Copilot pueden usar servers:

{
  "servers": {
    "dr-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@inferensys/dr-mcp", "server"]
    }
  }
}

Zed

{
  "context_servers": {
    "dr-mcp": {
      "command": "npx",
      "args": ["-y", "@inferensys/dr-mcp", "server"]
    }
  }
}

Continue

mcpServers:
  dr-mcp:
    command: npx
    args:
      - -y
      - @inferensys/dr-mcp
      - server

Herramientas MCP

Cuando se ejecuta como servidor, dr-mcp expone:

dr_mcp_scan
dr_mcp_cleanup
scan_mcp_setup
explain_issue
generate_patch_plan
apply_patch_plan
export_report

Prompts MCP

dr_mcp con action=scan o action=cleanup
dr_mcp_scan
dr_mcp_cleanup

Seguridad

Los escaneos nunca editan configuraciones de clientes MCP.

Los planes de parche crean copias de seguridad con marca de tiempo antes de escribir. Los informes redactan secretos, tokens, correos electrónicos, rutas de inicio y URLs de repositorios privados de GitHub.

El seguimiento de uso es opcional. --track-usage escribe un registro local en ~/.dr-mcp/usage-ledger.json. Rastrea lo que permanece instalado entre escaneos; no afirma un uso real por herramienta a menos que un cliente exponga esos datos.

dr-mcp no instala automáticamente, desinstala, actualiza paquetes ni ejecuta limpieza destructiva.

Desarrollo

npm install
npm run check
node dist/cli.js scan --workspace tests/fixtures/mixed --json

Nombre del registro: io.github.Inferensys/dr-mcp

Paquete: @inferensys/dr-mcp