DebugMCP (MCP server) — Anwendungsfälle, Installieren & Live-Demo

Name: DebugMCP MCP Server
Author: microsoft

Warum nutzen

Hauptfunktionen

14 Debugger-Tools — starten/stoppen, step over/into/out, Breakpoints, evaluieren
Zeileninhalt-Breakpoints (robust gegenüber Quellcode-Änderungen)
9 Sprachen über bestehende VS Code-Spracherweiterungen unterstützt
100% lokal — keine Telemetrie, keine Credentials nötig
Registriert MCP-Server automatisch bei Erweiterungsaktivierung

Live-Demo

In der Praxis

debug-mcp-microsoft.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/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"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

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

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

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

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

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: DebugMCP

Claude durch einen fehlschlagenden Test steppen lassen statt Print-Debugging

👤 Backend- / App-Entwickler ⏱ ~15 min beginner

Wann einsetzen: Ein Test schlägt ohne klaren Stack-Trace fehl — Print-Debugging würde ewig dauern.

Voraussetzungen

DebugMCP in VS Code installiert — Marketplace → ozzafar.debugmcpextension
Sprach-Debug-Erweiterung (z. B. Python für .py) — VS Code fragt beim ersten Start automatisch nach

Ablauf

Einrichten

Use debugmcp. Add a breakpoint on the line assert result == expected in tests/test_orders.py.✓ Kopiert

→ Breakpoint als gesetzt gemeldet; Zeileninhalt abgeglichen
Ausführen

Start debugging tests/test_orders.py with the failing test.✓ Kopiert

→ Session am Breakpoint pausiert
Inspizieren

Show me all local variables. What's result actually contain?✓ Kopiert

→ Variablen-Dump mit konkreten Werten
Steppen und diagnostizieren

Step into the function that built result. Tell me where it diverged from expected.✓ Kopiert

→ Code-verankerte Ursache

Ergebnis: Bug durch Stepping gefunden, nicht geraten — Minuten statt einer Stunde.

Fallstricke

Breakpoint per Zeilennummer verschiebt sich nach Änderungen — Zeileninhalt-Matching verwenden (DebugMCP unterstützt das nativ)

Kombinieren mit: filesystem

Einen Heisenbug mit konditionalen Breakpoints eingrenzen

👤 Devs mit intermittierenden Bugs ⏱ ~25 min intermediate

Wann einsetzen: Bug tritt nur bei bestimmten Eingaben auf — du musst nur in diesem Fall anhalten.

Ablauf

Konditionaler Breakpoint

Add a breakpoint at the process(order) call that fires only when order.id starts with 'EXP-'.✓ Kopiert

→ Konditionaler Breakpoint gesetzt
Reproduktion antreiben

Run the integration suite. When we stop, evaluate the order DTO and the request headers.✓ Kopiert

→ Exakt fehlgeschlagene Eingabe erfasst

Ergebnis: Heisenbug wird zu einem normalen Bug.

Fallstricke

Konditionale Auswertung verlangsamt die Schleife — Bedingung eingrenzen; keine Seiteneffekte in der Bedingung

Den Debugger als Dokumentation für unbekannten Code nutzen

👤 Neue Mitarbeiter, die einen Dienst kennenlernen ⏱ ~30 min beginner

Wann einsetzen: Du hast einen Dienst geerbt und der Datenfluss ist undurchsichtig.

Ablauf

Einstieg verfolgen

Set a breakpoint at the HTTP handler for /orders. Run a sample request and step through every call until response is returned. Narrate as you go.✓ Kopiert

→ Schritt-für-Schritt-Trace mit Datei:Zeile-Annotationen

Ergebnis: Eine Verhaltenskarte des Dienstes, die kein Diagramm je erfasst hat.

Fallstricke

Trace wird zu tief — step_over für langweilige Frames verwenden, step_into nur für interessante

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

debug-mcp-microsoft + filesystem

Quellcode lesen während des Steppings, um die nächste Aktion zu entscheiden

Step into the call. While paused, show me the surrounding function via filesystem.✓ Kopiert

debug-mcp-microsoft + github

PR mit dem Fix öffnen, der gerade via Debugger verifiziert wurde

We confirmed the bug. Open a PR with the fix and reference the debug session in the description.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
start_debugging	fileFullPath, workingDirectory, testName?, configurationName?	Debug-Session beginnen	free
add_breakpoint	fileFullPath, lineContent	Haltepunkt per Code-Inhalt setzen	free
step_over	(none)	Eine Quellzeile weitergehen	free
step_into	(none)	In die aufgerufene Funktion einsteigen	free
get_variables_values	scope: 'local'\|'global'\|'all'	Zustand am aktuellen Pausepunkt inspizieren	free
evaluate_expression	expression: str	Hypothesen testen ohne erneutes Ausführen	free
list_breakpoints	(none)	Aktuelle Breakpoints überblicken	free

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Lokal — kein Kontingent
Tokens pro Aufruf: 100–500 pro Debug-Aktion
Kosten in €: Kostenlos (MIT)
Tipp: Stepping ist günstiger als Print-Debug-Schleifen; tokens gegen schnellere Diagnose tauschen

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Local file read for source mapping

Credential-Speicherung: Keine — keine Credentials nötig

Datenabfluss: Keine — vollständig lokal

Niemals gewähren: Network exposure of port 3001

Nicht an 0.0.0.0 binden; auf localhost beschränken

Fehlerbehebung

Häufige Fehler und Lösungen

MCP server not detected after install

VS Code neu starten; sicherstellen, dass die Erweiterung aktiviert ist und Port 3001 frei ist

Prüfen: curl http://localhost:3001/mcp

Language not supported

Zuerst die passende VS Code-Sprach-Debug-Erweiterung installieren (z. B. ms-python.python für Python)

Prüfen: Debug manuell über VS Code UI starten, um es zu bestätigen

Breakpoint never hits

Source-Map-Abweichung — sicherstellen, dass dasselbe Artefakt debuggt wird, das bearbeitet wurde

Prüfen: launch.json `program`-Pfad prüfen

Alternativen

DebugMCP vs. andere

Alternative	Wann stattdessen	Kompromiss
Print / log statements	Schnelle Einmalsache, kein IDE angebunden	Günstig, aber langsam beim Iterieren; verschmutzt die Codebasis
Language-specific REPL	Nur Post-Mortem-Inspektion gewünscht	Kein Live-Stepping; weniger umfangreich als vollständiger Debugger

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen