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

Name: DebugMCP MCP Server
Author: microsoft

Por qué usarlo

Características clave

14 herramientas de depuración — start/stop, step over/into/out, breakpoints, evaluate
Breakpoints por contenido de línea (resistentes a ediciones del código fuente)
9 lenguajes soportados a través de las extensiones de lenguaje existentes de VS Code
100% local — sin telemetría, sin credenciales necesarias
Se registra como servidor MCP automáticamente al activar la extensión

Demo en vivo

Cómo se ve en la práctica

debug-mcp-microsoft.replay ▶ listo

0/0

Instalar

Elige tu 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"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: DebugMCP

Hacer que Claude recorra un test fallido en lugar de leer prints

👤 Devs de backend / aplicaciones ⏱ ~15 min beginner

Cuándo usarlo: Un test falla sin stack trace claro — el debug con prints tardará una eternidad.

Requisitos previos

DebugMCP instalado en VS Code — Marketplace → ozzafar.debugmcpextension
Extensión de depuración del lenguaje (p. ej., Python para .py) — VS Code lo sugiere automáticamente en el primer uso

Flujo

Configurar

Usa debugmcp. Añade un breakpoint en la línea assert result == expected en tests/test_orders.py.✓ Copiado

→ Breakpoint establecido; contenido de línea coincide
Ejecutar

Inicia la depuración de tests/test_orders.py con el test fallido.✓ Copiado

→ Sesión pausada en el breakpoint
Inspeccionar

Muéstrame todas las variables locales. ¿Qué contiene realmente result?✓ Copiado

→ Volcado de variables con valores concretos
Avanzar + diagnosticar

Entra en la función que construyó result. Dime dónde divergió del valor esperado.✓ Copiado

→ Causa raíz anclada al código

Resultado: Bug localizado por stepping, no por suposiciones — minutos en lugar de una hora.

Errores comunes

El breakpoint por número de línea se desplaza tras ediciones — Usa la coincidencia por contenido de línea (DebugMCP lo soporta nativamente)

Combinar con: filesystem

Acotar un heisenbug con breakpoints condicionales

👤 Devs que enfrentan bugs intermitentes ⏱ ~25 min intermediate

Cuándo usarlo: El bug solo se reproduce con una entrada específica — necesitas pausar solo en ese caso.

Flujo

Breakpoint condicional

Añade un breakpoint en la llamada process(order) que se active solo cuando order.id empiece con 'EXP-'.✓ Copiado

→ Breakpoint condicional instalado
Forzar reproducción

Ejecuta la suite de integración. Al detenernos, evalúa el DTO del pedido y los headers de la petición.✓ Copiado

→ Entrada exacta del fallo capturada

Resultado: El heisenbug se convierte en un bug normal.

Errores comunes

La evaluación condicional ralentiza el bucle — Acota la condición; mantenla pura (sin efectos secundarios)

Usar el depurador como documentación para código desconocido

👤 Nuevos integrantes incorporándose a un servicio ⏱ ~30 min beginner

Cuándo usarlo: Heredaste un servicio y el flujo de datos es opaco.

Flujo

Rastrear entrada

Establece un breakpoint en el handler HTTP de /orders. Ejecuta una petición de ejemplo y recorre cada llamada hasta que se devuelva la respuesta. Narra mientras avanzas.✓ Copiado

→ Traza paso a paso con anotaciones file:line

Resultado: Un mapa de comportamiento del servicio que ningún diagrama capturaba.

Errores comunes

La traza se vuelve demasiado profunda — Usa step_over para frames aburridos, step_into solo en los interesantes

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

debug-mcp-microsoft + filesystem

Leer el código fuente mientras se avanza para decidir el siguiente paso

Entra en la llamada. Mientras estés pausado, muéstrame la función circundante via filesystem.✓ Copiado

debug-mcp-microsoft + github

Abrir un PR con el fix que acabas de verificar con el depurador

Confirmamos el bug. Abre un PR con el fix y referencia la sesión de depuración en la descripción.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
start_debugging	fileFullPath, workingDirectory, testName?, configurationName?	Iniciar una sesión de depuración	free
add_breakpoint	fileFullPath, lineContent	Marcar un punto de pausa por contenido de código	free
step_over	(ninguno)	Avanzar una línea fuente	free
step_into	(ninguno)	Descender en la función llamada	free
get_variables_values	scope: 'local'\|'global'\|'all'	Inspeccionar el estado en el punto de pausa actual	free
evaluate_expression	expression: str	Probar hipótesis sin volver a ejecutar	free
list_breakpoints	(ninguno)	Auditar el conjunto de trampas actual	free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Local — sin cuota
Tokens por llamada: 100–500 por acción de depuración
Monetario: Gratis (MIT)
Consejo: El stepping es más barato que iterar bucles de print-debug; intercambia tokens por diagnóstico más rápido

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Local file read for source mapping

Almacenamiento de credenciales: Ninguno — no se necesitan credenciales

Salida de datos: Ninguno — completamente local

No conceder nunca: Network exposure of port 3001

No bindees en 0.0.0.0; mantenlo en localhost

Resolución de problemas

Errores comunes y soluciones

Servidor MCP no detectado tras la instalación

Reinicia VS Code; asegúrate de que la extensión esté habilitada y el puerto 3001 libre

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

Lenguaje no soportado

Instala primero la extensión de depuración de lenguaje correspondiente en VS Code (p. ej., ms-python.python para Python)

Verificar: Ejecuta la depuración manualmente desde la UI de VS Code para confirmar

El breakpoint nunca se activa

Mismatch de source map — confirma que estás depurando el mismo artefacto que editaste

Verificar: Comprueba la ruta `program` en launch.json

Alternativas

DebugMCP vs otros

Alternativa	Cuándo usarla	Contrapartida
Sentencias print / log	Caso puntual rápido, sin IDE adjunto	Barato pero lento de iterar; contamina el código
REPL específico del lenguaje	Solo necesitas inspección post-mortem	Sin stepping en vivo; menos rico que el depurador completo

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills