dr-mcp

Limpe e audite configurações MCP bagunçadas: servidores obsoletos, ferramentas não utilizadas, MCPs com excesso de contexto, pacotes desatualizados e planos de reparo seguros.

GitHubExperimente este MCPPatrocinado

Documentação

dr-mcp

Limpe seus MCPs.

dr-mcp é uma ferramenta local-first de auditoria e limpeza de MCPs para desenvolvedores que usam codificação agêntica diariamente. Ela verifica as configurações do Model Context Protocol que suas ferramentas carregam, encontra servidores obsoletos, pacotes abandonados, entradas duplicadas, ferramentas que consomem muito contexto, permissões arriscadas e grandes atualizações, e então gera planos de correção reversíveis.

Se você usa Claude Code, OpenAI Codex, Cursor, Windsurf, GitHub Copilot, VS Code, Cline, Roo Code, Continue ou Zed em vários projetos, sua configuração de MCP pode crescer silenciosamente: servidores demo antigos, ferramentas GitHub duplicadas, acesso amplo ao sistema de arquivos, pacotes fixados atrás do npm latest, repositórios abandonados e grandes superfícies de ferramentas que seu agente precisa considerar antes de escrever código.

dr-mcp mostra o que limpar sem excluir nada durante a varredura.

npx @inferensys/dr-mcp cleanup

Isso inicia uma varredura de limpeza local no projeto atual. Você recebe um relatório com dados redigidos, uma lista classificada de MCPs que consomem muito contexto, sinais de atualização de pacotes e repositórios, e planos de correção que você pode aplicar após revisão.

Para a varredura de limpeza completa com verificações de pacotes/repositórios e rastreamento do histórico local de instalação:

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

Dentro do Claude Code, Codex, Cursor, Windsurf, GitHub Copilot ou qualquer cliente MCP que exponha prompts/ferramentas de servidor, use dr_mcp_scan ou dr_mcp_cleanup. Se seu cliente mapeia prompts MCP em comandos de barra, use /dr-mcp scan.

Por que limpar seus MCPs?

Servidores MCP são poderosos porque colocam ferramentas diretamente no loop do agente. Isso também significa que cada servidor extra pode adicionar ruído na seleção de ferramentas, pressão na janela de contexto, falhas de inicialização, dependências obsoletas ou permissões que você não pretende mais conceder.

dr-mcp ajuda com:

Auditoria de MCP: um relatório abrangente das configurações globais e do projeto.
Limpeza de MCP: revisão de candidatos para duplicatas, entradas mortas, pacotes abandonados, instalações de longa duração e superfícies de ferramentas pesadas.
Higiene de contexto de MCP: estimativas de contagem de ferramentas e peso de contexto para servidores que não pertencem a toda sessão de codificação.
Revisão de segurança de MCP: acesso amplo ao sistema de arquivos, segredos inline, argumentos com aparência de segredo e referências de ambiente quebradas.
Planejamento de atualização de MCP: desvio semver em relação ao npm latest, incluindo grandes atualizações que merecem revisão.
Planos de reparo de MCP: operações explícitas com backups e diffs antes de gravar.

O que ajuda a corrigir

Recupere contexto. Veja quais MCPs adicionam as maiores listas de ferramentas ao prompt do seu agente.
Reduza chamadas de ferramentas indesejadas. Remova servidores antigos que seu agente continua considerando mesmo quando o projeto não precisa deles.
Abandone MCPs obsoletos. Com --registry, verifique metadados npm e atividade no GitHub para projetos arquivados ou desatualizados.
Veja grandes atualizações. Encontre pacotes MCP fixados muito atrás do npm latest e revise planos de atualização.
Encontre sobras. Ative --track-usage e construa um registro local de MCPs que continuam aparecendo nas varreduras.
Remova duplicatas. Identifique o mesmo MCP registrado em Claude, Cursor, VS Code, Codex, Windsurf ou arquivos de projeto.
Corrija configurações arriscadas. Sinalize acesso amplo ao sistema de arquivos, segredos inline, argumentos com aparência de segredo, comandos ausentes, caminhos mortos e referências de ambiente quebradas.
Pare instalações flutuantes. Capture pacotes npx usando latest ou sem versão.

Como funciona a auditoria

dr-mcp usa análise estática prática e verificações de metadados de pacotes:

Descubra arquivos de configuração para Claude Desktop, Claude Code, Codex, Cursor, Windsurf, GitHub Copilot, VS Code, Cline, Roo Code, Continue, Zed e .mcp.json.
Analise e normalize formatos de configuração JSON, TOML e YAML em um modelo interno único de servidor MCP.
Pontue a configuração em confiabilidade, segurança, higiene de contexto e manutenibilidade.
Verifique a atualização dos pacotes com metadados npm, classificação semver, dist-tags.latest e correspondência opcional com o registro oficial.
Estime o peso de contexto com heurísticas de cardinalidade de ferramentas para MCPs de alta superfície, como GitHub, automação de navegador, Slack, Jira, sistema de arquivos e bancos de dados.
Revise sinais de manutenção do status de arquivamento no GitHub e atividade recente de push quando os metadados do repositório estiverem disponíveis.
Gere planos de correção com alvos JSON Pointer, operações idempotentes, backups com timestamp e 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

Seções do relatório

Pontuação: confiabilidade, segurança, higiene de contexto, manutenibilidade.
Atualizações de pacotes: pacotes MCP fixados atrás do npm latest, incluindo grandes atualizações.
Peso de contexto: MCPs classificados pela carga estimada de ferramentas.
Histórico de instalação: servidores de longa duração do registro local de uso.
Descobertas: problemas concretos com caminhos de configuração de origem.
Planos de correção: edições seguras, como remover duplicatas, entradas mortas, servidores abandonados ou servidores que consomem muito contexto.

Planos de limpeza

dr-mcp separa descobertas de ações. Uma descoberta informa o que parece errado; um plano de correção informa a edição exata de configuração que pode fazer.

remove-duplicate-servers: remove entradas duplicadas de servidor MCP mantendo a primeira definição habilitada.
remove-dead-servers: remove entradas que não podem ser iniciadas ou pacotes ausentes no npm.
upgrade-stale-packages: atualiza referências de pacotes MCP para o npm latest.
remove-abandoned-servers: remove servidores de repositórios arquivados ou abandonados.
remove-heavy-context-servers: remove servidores estimados para carregar muitas ferramentas em cada sessão.
remove-long-lived-servers: remove servidores que permaneceram instalados em várias varreduras rastreadas após você confirmar que não são mais úteis.

Ferramentas suportadas

Ferramenta	Configs verificadas
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 no VS Code	Configurações de usuário do VS Code, configurações do 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`, caminhos comuns de armazenamento global do Roo Code VS Code
Continue	`~/.continue/config.yaml`, `.continue/config.yaml`
Zed	Configurações de usuário do Zed, `.zed/settings.json`
MCP genérico	`.mcp.json`

Adicione dr-mcp ao seu agente

Depois de adicionado, comece pela ação mais curta na sessão:

dr_mcp_scan

Para candidatos de limpeza, atualizações, servidores abandonados e instalações de longa duração:

dr_mcp_cleanup

Clientes que expõem prompts MCP como comandos de barra podem mostrá-los como dr_mcp_scan, dr_mcp_cleanup ou um 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 configuração JSON

Use isto para Claude Desktop, Cursor, Windsurf, Cline, Roo Code, VS Code e GitHub Copilot no VS Code:

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

VS Code e GitHub Copilot podem 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

Ferramentas MCP

Quando executado como servidor, dr-mcp expõe:

dr_mcp_scan
dr_mcp_cleanup
scan_mcp_setup
explain_issue
generate_patch_plan
apply_patch_plan
export_report

Prompts MCP

dr_mcp com action=scan ou action=cleanup
dr_mcp_scan
dr_mcp_cleanup

Segurança

As varreduras nunca editam configurações de clientes MCP.

Os planos de correção criam backups com timestamp antes de gravar. Os relatórios redigem segredos, tokens, e-mails, caminhos pessoais e URLs privadas de repositórios GitHub.

O rastreamento de uso é opcional. --track-usage grava um registro local em ~/.dr-mcp/usage-ledger.json. Ele rastreia o que permanece instalado entre varreduras; não afirma uso real por ferramenta, a menos que um cliente exponha esses dados.

dr-mcp não instala, desinstala, atualiza pacotes automaticamente nem executa limpeza destrutiva.

Desenvolvimento

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

Nome do registro: io.github.Inferensys/dr-mcp

Pacote: @inferensys/dr-mcp