DebugMCP (MCP server) — Casos de uso, Instalar & Demo ao vivo

Name: DebugMCP MCP Server
Author: microsoft

Por que usar

Principais recursos

14 ferramentas de depuração — iniciar/parar, step over/into/out, breakpoints, avaliar
Breakpoints por conteúdo de linha (resistente a edições no código-fonte)
9 linguagens suportadas via extensões de linguagem existentes do VS Code
100% local — sem telemetria, sem credenciais necessárias
Registra o servidor MCP automaticamente ao ativar a extensão

Demo ao vivo

Como fica na prática

debug-mcp-microsoft.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "debug-mcp-microsoft",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "debug-mcp-microsoft": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "http://localhost:3001/mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add debug-mcp-microsoft -- npx -y mcp-remote http://localhost:3001/mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: DebugMCP

Fazer o Claude avançar por um teste com falha em vez de ler prints

👤 Devs de backend/aplicações ⏱ ~15 min beginner

Quando usar: Um teste falha sem uma stack clara — depuração com print vai levar uma eternidade.

Pré-requisitos

DebugMCP instalado no VS Code — Marketplace → ozzafar.debugmcpextension
Extensão de depuração de linguagem (ex.: Python para .py) — O VS Code solicita automaticamente na primeira execução

Fluxo

Configurar

Use debugmcp. Adicione um breakpoint na linha assert result == expected em tests/test_orders.py.✓ Copiado

→ Breakpoint reportado como definido; conteúdo da linha correspondido
Executar

Inicie a depuração de tests/test_orders.py com o teste com falha.✓ Copiado

→ Sessão pausada no breakpoint
Inspecionar

Mostre-me todas as variáveis locais. O que result realmente contém?✓ Copiado

→ Dump de variáveis com valores concretos
Avançar e diagnosticar

Entre na função que construiu result. Diga-me onde ela divergiu do esperado.✓ Copiado

→ Causa raiz ancorada no código

Resultado: Bug localizado por stepping, não por adivinhação — minutos em vez de uma hora.

Armadilhas

Breakpoint por número de linha deriva após edições — Use correspondência por conteúdo de linha (DebugMCP suporta isso nativamente)

Combine com: filesystem

Identificar um heisenbug com breakpoints condicionais

👤 Devs enfrentando bugs intermitentes ⏱ ~25 min intermediate

Quando usar: O bug só se reproduz sob entrada específica — você precisa parar apenas nesse caso.

Fluxo

Breakpoint condicional

Adicione um breakpoint na chamada process(order) que dispara apenas quando order.id começa com 'EXP-'.✓ Copiado

→ Breakpoint condicional instalado
Conduzir reprodução

Execute a suíte de integração. Quando parar, avalie o DTO do pedido e os headers da requisição.✓ Copiado

→ Entrada exata com falha capturada

Resultado: Heisenbug se torna um bug comum.

Armadilhas

A avaliação condicional desacelera o loop — Restrinja a condição; mantenha-a pura (sem efeitos colaterais)

Usar o depurador como documentação para código desconhecido

👤 Novos contratados fazendo onboarding em um serviço ⏱ ~30 min beginner

Quando usar: Você herdou um serviço e o fluxo de dados é opaco.

Fluxo

Rastrear entrada

Defina um breakpoint no handler HTTP para /orders. Execute uma requisição de exemplo e avance por cada chamada até a resposta ser retornada. Narre enquanto avança.✓ Copiado

→ Rastreamento passo a passo com anotações file:line

Resultado: Um mapa comportamental do serviço que nenhum diagrama capturou.

Armadilhas

O rastreamento fica muito profundo — Use step_over para frames conhecidamente sem interesse, step_into apenas nos interessantes

Combinações

Combine com outros MCPs para 10× de alavancagem

debug-mcp-microsoft + filesystem

Ler o código-fonte enquanto avança para decidir o próximo passo

Entre na chamada. Enquanto pausado, mostre-me a função adjacente via filesystem.✓ Copiado

debug-mcp-microsoft + github

Abrir um PR com a correção que você acabou de verificar via depurador

Confirmamos o bug. Abra um PR com a correção e referencie a sessão de depuração na descrição.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
start_debugging	fileFullPath, workingDirectory, testName?, configurationName?	Iniciar uma sessão de depuração	free
add_breakpoint	fileFullPath, lineContent	Marcar um ponto de parada por conteúdo do código	free
step_over	(nenhum)	Avançar uma linha de código-fonte	free
step_into	(nenhum)	Entrar na função chamada	free
get_variables_values	scope: 'local'\|'global'\|'all'	Inspecionar o estado no ponto de pausa atual	free
evaluate_expression	expression: str	Testar hipóteses sem re-executar	free
list_breakpoints	(nenhum)	Auditar o conjunto de pontos de parada atuais	free

Custo e limites

O que custa rodar

Cota de API: Local — sem quota
Tokens por chamada: 100–500 por ação de depuração
Monetário: Gratuito (MIT)
Dica: O stepping é mais barato que iterações de print-debug; troque tokens por diagnóstico mais rápido

Segurança

Permissões, segredos, alcance

Escopos mínimos: Leitura local de arquivos para mapeamento de código-fonte

Armazenamento de credenciais: Nenhum — nenhuma credencial necessária

Saída de dados: Nenhuma — totalmente local

Nunca conceda: Exposição de rede da porta 3001

Não vincule em 0.0.0.0; mantenha no localhost

Solução de problemas

Erros comuns e correções

Servidor MCP não detectado após instalação

Reinicie o VS Code; certifique-se de que a extensão está habilitada e a porta 3001 está livre

Verificar: curl http://localhost:3001/mcp

Linguagem não suportada

Instale primeiro a extensão de depuração de linguagem correspondente no VS Code (ex.: ms-python.python para Python)

Verificar: Execute a depuração manualmente na UI do VS Code para confirmar

Breakpoint nunca é atingido

Incompatibilidade de source map — confirme que está depurando o mesmo artefato que editou

Verificar: Verifique o caminho `program` no launch.json

Alternativas

DebugMCP vs. outros

Alternativa	Quando usar	Troca
Instruções de print / log	Uso rápido pontual, sem IDE conectada	Barato mas lento para iterar; polui o código-fonte
REPL específico da linguagem	Você quer apenas inspeção post-mortem	Sem stepping ao vivo; menos rico que o depurador completo

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills