mcp-checkup

Analiza tu configuración de MCP: mide el costo de tokens por herramienta, encuentra esquemas inflados, detecta duplicados y obtén consejos de optimización para recuperar tu ventana de contexto.

GitHub
1
Prueba este MCPPatrocinado

Documentación

mcp-checkup

npm version npm downloads License: MIT

Tus servidores MCP están devorando tu ventana de contexto. Descubre cuánto.

mcp-checkup es un servidor MCP que analiza tu configuración de MCP — midiendo el costo en tokens de cada servidor y herramienta instalados, encontrando duplicados, calificando la eficiencia y generando informes de optimización.

Inicio rápido

npx mcp-checkup

Luego pregúntale a tu asistente de IA:

"Run an MCP health check on my setup"
"How many tokens are my MCP servers using?"
"Generate an MCP health report"

¿Por qué?

Cada herramienta MCP cuesta 550–1,400 tokens solo por su esquema. Un servidor con 50 herramientas puede consumir 30,000+ tokens antes de que escribas nada. La mayoría de los desarrolladores no tienen idea de cuánta ventana de contexto están consumiendo sus servidores MCP.

Ejemplos reales de la comunidad:

  • Agregar GitHub MCP aumentó el uso de tokens de un usuario de 34K a 80K (fuente)
  • Un desarrollador encontró 67,000 tokens consumidos por solo 4 servidores antes de cualquier conversación (fuente)
  • Context7 (240K descargas semanales) tiene descripciones de herramientas que cuestan 3 veces más tokens de lo necesario (fuente)

Herramientas

analyze_servers

Escanea tu configuración de MCP y mide el costo en tokens de cada servidor instalado. Detecta automáticamente los archivos de configuración.

"Which of my MCP servers costs the most tokens?"

analyze_tools

Análisis profundo de un servidor específico — costos de tokens por herramienta, calificaciones, descripciones infladas y sugerencias de optimización.

"Break down the token cost of my GitHub MCP server"

find_duplicates

Encuentra nombres de herramientas duplicados entre tus servidores instalados. Las herramientas redundantes desperdician contexto sin beneficio.

"Do any of my MCP servers have overlapping tools?"

count_tokens

Cuenta tokens en cualquier texto. Útil para estimar el uso de contexto.

"How many tokens is this prompt?"

generate_report

Informe de salud completo en markdown: calificaciones de servidores (A-F), costos de tokens, duplicados y recomendaciones accionables.

"Generate a full MCP health report"

Sistema de Calificación

Calificaciones por Herramienta

CalificaciónTokensSignificado
A≤100Excelente — costo de contexto mínimo
B≤300Bueno — tamaño de esquema razonable
C≤600Aceptable — podría optimizarse
D≤1000Pobre — esquema inflado
F>1000Deficiente — impacta severamente la ventana de contexto

Calificaciones por Servidor

CalificaciónTokens TotalesSignificado
A≤500Ágil y eficiente
B≤1500Razonable
C≤3000Se está volviendo pesado
D≤6000Costo de contexto significativo
F>6000Drenaje importante de la ventana de contexto

Instalación

Claude Desktop / Claude Code

{
  "mcpServers": {
    "mcp-checkup": {
      "command": "npx",
      "args": ["-y", "mcp-checkup"]
    }
  }
}

Cursor

Agrega a .cursor/mcp.json con el mismo formato.

Detección Automática

mcp-checkup encuentra automáticamente tu configuración de MCP en estas ubicaciones:

  • .mcp.json (directorio actual)
  • Configuración de Claude Desktop (Windows/macOS/Linux)
  • .cursor/mcp.json

O pasa una ruta personalizada a cualquier herramienta.

Cómo se Compara

HerramientaPropósitoEnfoque
mcp-checkupDiagnosticar costos de tokensAnalizar e informar — ve exactamente cuánto cuesta cada herramienta
lean-ctxReducir el uso de tokensComprimir contexto en tiempo de ejecución
MCP InspectorDepurar servidores MCPProbar conexiones y llamadas a herramientas

Usa mcp-checkup primero para encontrar el problema, luego decide cómo solucionarlo.

Parte del MCP Toolkit

Ver todos los servidores →

Licencia

MIT