mcp-checkup

Analise sua configuração MCP: meça o custo de tokens por ferramenta, encontre esquemas inchados, detecte duplicatas e obtenha dicas de otimização para recuperar sua janela de contexto.

GitHub
1
Experimente este MCPPatrocinado

Documentação

mcp-checkup

npm version npm downloads License: MIT

Seus servidores MCP estão consumindo sua janela de contexto. Descubra o quanto.

mcp-checkup é um servidor MCP que analisa sua configuração MCP — medindo o custo em tokens de cada servidor e ferramenta instalados, encontrando duplicatas, avaliando eficiência e gerando relatórios de otimização.

Início Rápido

npx mcp-checkup

Depois, pergunte ao seu assistente 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 ferramenta MCP custa 550–1.400 tokens apenas pelo seu schema. Um servidor com 50 ferramentas pode consumir 30.000+ tokens antes mesmo de você digitar qualquer coisa. A maioria dos desenvolvedores não tem ideia de quanto da janela de contexto seus servidores MCP estão consumindo.

Exemplos reais da comunidade:

  • Adicionar o GitHub MCP aumentou o uso de tokens de um usuário de 34K para 80K (fonte)
  • Um desenvolvedor descobriu 67.000 tokens consumidos por apenas 4 servidores antes de qualquer conversa (fonte)
  • O Context7 (240K downloads semanais) tem descrições de ferramentas que custam 3x mais tokens do que o necessário (fonte)

Ferramentas

analyze_servers

Escaneie sua configuração MCP e meça o custo em tokens de cada servidor instalado. Detecta automaticamente os arquivos de configuração.

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

analyze_tools

Aprofunde-se em um servidor específico — custos de tokens por ferramenta, notas, descrições inchadas e sugestões de otimização.

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

find_duplicates

Encontre nomes de ferramentas duplicados entre seus servidores instalados. Ferramentas redundantes desperdiçam contexto sem nenhum benefício.

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

count_tokens

Conte tokens em qualquer texto. Útil para estimar o uso de contexto.

"How many tokens is this prompt?"

generate_report

Relatório completo de saúde em markdown: notas dos servidores (A-F), custos de tokens, duplicatas e recomendações acionáveis.

"Generate a full MCP health report"

Sistema de Notas

Notas por Ferramenta

NotaTokensSignificado
A≤100Excelente — custo mínimo de contexto
B≤300Bom — tamanho de schema razoável
C≤600Razoável — poderia ser otimizado
D≤1000Ruim — schema inchado
F>1000Reprovado — impacta severamente a janela de contexto

Notas por Servidor

NotaTotal de TokensSignificado
A≤500Enxuto e eficiente
B≤1500Razoável
C≤3000Ficando pesado
D≤6000Custo de contexto significativo
F>6000Grande dreno na janela de contexto

Instalação

Claude Desktop / Claude Code

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

Cursor

Adicione em .cursor/mcp.json com o mesmo formato.

Detecção Automática

O mcp-checkup encontra automaticamente sua configuração MCP nestes locais:

  • .mcp.json (diretório atual)
  • Config do Claude Desktop (Windows/macOS/Linux)
  • .cursor/mcp.json

Ou passe um caminho personalizado para qualquer ferramenta.

Como Ele se Compara

FerramentaPropósitoAbordagem
mcp-checkupDiagnosticar custos de tokensAnalisar e relatar — veja exatamente quanto cada ferramenta custa
lean-ctxReduzir uso de tokensComprimir contexto em tempo de execução
MCP InspectorDepurar servidores MCPTestar conexões e chamadas de ferramentas

Use o mcp-checkup primeiro para encontrar o problema, depois decida como corrigi-lo.

Parte do MCP Toolkit

Ver todos os servidores →

Licença

MIT