MCP Debug Tools - ferramenta auxiliar de depuração para IA

Ponte de depuração AI-VSCode - a IA investiga bugs com base em dados.

MCP Debug Tools é um projeto open source que conecta o Debug Adapter Protocol (DAP) da Microsoft ao Model Context Protocol (MCP) da Anthropic. Com essa ferramenta, IAs como Claude, Cursor e Windsurf passam a poder controlar diretamente os poderosos recursos de depuração do VSCode.

Before (forma anterior)

Desenvolvedor: "Os dados agregados do componente exibido no menu A são diferentes dos dados exibidos no menu B. Precisamos encontrar o bug."  
IA: "Analisando o código... encontrei um problema na estrutura do código."  
Desenvolvedor: "O sintoma continua exatamente o mesmo"  
IA: "Vou analisar mais a fundo. Comparando tipos e estruturas de dados..."  
Desenvolvedor: "O problema ainda não foi resolvido"  
IA: "Preciso de mais logs. Vou adicionar logs e tentar novamente."  
Desenvolvedor: "O problema ainda não foi resolvido"  
  
[Repetição...]  

After (MCP Debug Tools)

Desenvolvedor: "Os dados agregados do componente exibido no menu A são diferentes dos dados exibidos no menu B. Compare os dados com base na depuração e verifique o problema."  
IA: "Vou comparar a posição do componente no menu A com a posição do componente no menu B."  
IA: "O componente do menu A está sendo renderizado na função Y do arquivo X, e o componente do menu B na função W do arquivo Z."  
IA: "Configurei um breakpoint na parte que busca os dados na função Y do arquivo X. Vou iniciar a depuração."  
  
[Sessão de depuração iniciada; a IA usa os recursos de depuração do VSCode para executar o código, inspecionar variáveis, verificar stack traces etc.]  
  
IA: "Cheguei ao breakpoint. Ao inspecionar as variáveis, vi que os dados do menu A usam diretamente o resultado da chamada de API, enquanto os dados do menu B usam dados em cache. Isso parece estar causando a inconsistência."  
IA: "Correção do código concluída, vou reiniciar a sessão de depuração."  
  
[Sessão de depuração reiniciada, execução do código, inspeção de variáveis]  
  
IA: "Confirmei que os dados agora coincidem. Parece que o problema foi resolvido."  
Desenvolvedor: "Resolvido!"  

Instalação (3 etapas)

# 1. Instalar a extensão do VSCode  
code --install-extension mcp-debug-tools  
  
# 2. Instalar o pacote npm (opcional)  
npm install -g @uhd_kr/mcp-debug-tools  
  
# 3. Conectar à ferramenta de IA  
# Adicionar o servidor MCP no Claude, Cursor, Windsurf etc.  
{  
  "mcpServers": {  
    "release_dap-proxy": {  
      "command": "npx",  
      "args": [  
        "-y",  
        "@uhd_kr/mcp-debug-tools@latest"  
      ]  
    }  
  }  
}  

Principais recursos

29 ferramentas poderosas de depuração

• Gerenciamento de breakpoints: suporte a condicionais e log points
• Controle de execução: Step In/Out/Over, Continue, Pause
• Inspeção de variáveis: rastreamento de valores em tempo real, avaliação de expressões
• Análise de call stack: visualização da cadeia de chamadas de função
• Suporte a multithreading: depuração de Worker Threads e SharedArrayBuffer

5 recursos de monitoramento em tempo real

• Estado da sessão de depuração ativa
• Lista de breakpoints
• Informações de call stack
• Escopos de variáveis
• Informações de exceção e stack trace

Links

• GitHub: github.com/uhd-kr/mcp-debug-tools
• npm: @uhd_kr/mcp-debug-tools
• VSCode: marketplace.visualstudio.com
• Demo: demo no YouTube

Palavra do desenvolvedor

Depois de passar todos os dias gastando tempo depurando manualmente problemas no código gerado por IA, pensei:
"Uma IA que não consegue resolver problemas sozinha é como um iniciante que não sabe depurar."
Por isso, criei uma ferramenta que ajuda a IA a depurar.
Ao fornecer contexto para a IA, o mais importante são os dados reais.
Como a depuração permite observar em tempo real o fluxo de execução e o estado do código, ela ajuda muito a IA a entender com precisão o problema e propor uma solução.

Procurei seguir os princípios básicos do desenvolvimento.
Se o plano até agora com MCP Debug Tools foi criar uma ferramenta que permita à IA resolver problemas sozinha por meio da depuração,
a próxima etapa é criar uma ferramenta que ajude a IA a programar com hábitos corretos quando estiver escrevendo código por conta própria.
O objetivo final é reunir tudo isso para construir um pipeline de produção de código correto.

Espero que esta ferramenta seja de grande ajuda na jornada de desenvolvimento com IA de vocês.
Como desenvolvedor solo, preciso muito de feedbacks diversos.
Escrevo este texto porque quero receber ajuda com bug reports, sugestões de recursos e relatos de uso.

Obrigado.

Feedback: [e-mail]