DebugMCP (MCP Server) – Stärkung von KI-Agenten mit operativen Debugging-Fähigkeiten

Lassen Sie KI-Agenten Ihren Code in VS Code debuggen – Breakpoints setzen, Schritt für Schritt durch die Ausführung gehen, Variablen inspizieren und Ausdrücke auswerten. Funktioniert mit Codex, GitHub Copilot, GitHub Copilot CLI, Cline, Cursor, Windsurf, Roo Code und jedem MCP-kompatiblen Assistenten. Kompatibel mit jeder von VS Code unterstützten Codierungssprache.

⭐ Wenn Sie DebugMCP nützlich finden, markieren Sie das Repository auf GitHub mit einem Stern! Das hilft anderen, das Projekt zu entdecken, und motiviert die weitere Entwicklung.

📢 Hinweis für Entwickler: Diese Erweiterung wird von ozzafar@microsoft.com und orbarila@microsoft.com gepflegt. Wir freuen uns über Feedback und Beiträge, um diese Erweiterung zu verbessern.

🎬 Sehen Sie DebugMCP in Aktion – Ihr KI-Assistent setzt autonom Breakpoints, geht Schritt für Schritt durch den Code und inspiziert Variablen direkt in VS Code.

✨ Was ist neu

2.2

• Agentenübergreifende debug-live-Skill-Installation – der systematische Debugging-Workflow wird als Agent Skill ausgeliefert und jetzt in die Standard-Skill-Verzeichnisse installiert – ~/.agents/skills/ (das agentenübergreifende Verzeichnis, das von skill-kompatiblen Umgebungen, einschließlich des VS-Code-Agentenmodus, berücksichtigt wird) und ~/.copilot/skills/, falls vorhanden – sodass er überall auffindbar ist, anstatt neben der Konfiguration jedes Agenten kopiert zu werden, wo nichts ihn scannt (behebt #105, wo VS Code den Skill nie geladen hat). Der Server bewirbt auch MCP-instructions und das start_debugging-Tool verweist auf den Skill für den vollständigen Workflow.

• Laufende Programme anhalten – das neue pause_execution-Tool unterbricht ein frei laufendes Programm und stoppt an seiner aktuellen Position, auch ohne gesetzten Breakpoint (ideal für Endlosschleifen und eingebettete/Bare-Metal-Ziele), sodass Sie dann den Zustand inspizieren oder von dort aus schrittweise vorgehen können.

• Robustes Debugging über die VS-Code-Testing-API – start_debugging mit einem testName verwendet die VS-Code-Testing-API, um den Test zu entdecken und zu starten, was konsistente Breakpoint-Treffer innerhalb einzelner Testfälle über Sprach-Testrunner (pytest, Jest/Vitest, Java, .NET, Go usw.) erzeugt.

Related MCP server: MCP Server for VS Code

🚀 Schnellinstallation

Aus dem VS Code Marketplace installieren oder den direkten Link verwenden: vscode:extension/ozzafar.debugmcpextension

Inhaltsverzeichnis

• Übersicht

• Funktionen

• Installation

• Schnellstart

• Unterstützte KI-Assistenten

• Unterstützte Sprachen

• Konfiguration

• FAQ

• Fehlerbehebung

• So funktioniert es

• Mitwirken

• Lizenz

Übersicht

DebugMCP ist ein MCP-Server, der KI-Codierungsagenten die volle Kontrolle über den VS-Code-Debugger gibt. Anstatt Protokolle zu lesen oder zu raten, kann Ihr KI-Assistent autonom Breakpoints setzen, Debug-Sitzungen starten, Code Zeile für Zeile durchgehen, Variablenwerte inspizieren und Ausdrücke auswerten – genau wie ein menschlicher Entwickler. Er läuft zu 100 % lokal, erfordert keine Konfiguration und funktioniert sofort mit jedem MCP-kompatiblen KI-Assistenten.

Funktionen

🔧 Werkzeuge

Hinweis: Der MCP-Server stellt Werkzeuge für Debugger-Aktionen bereit, während die prozedurale Workflow-Anleitung (wann debuggen, wie eine Ursachenanalyse strukturiert wird, sprachspezifische Besonderheiten) im begleitenden Agent Skill lebt. Die Werkzeugbeschreibungen bleiben knapp und verhaltensorientiert; die Erweiterung installiert den debug-live-Skill in die Standard-Skill-Verzeichnisse (~/.agents/skills/, plus ~/.copilot/skills/, falls vorhanden), sodass skill-kompatible Umgebungen den vollständigen Workflow bei Bedarf laden. Der Server bewirbt auch MCP-instructions, die Agenten vor dem Debuggen darauf verweisen.

🎯 Best Practices für das Debugging

DebugMCP folgt systematischen Debugging-Praktiken für eine effektive Problemlösung:

• Mit Einstiegspunkten beginnen: Beginnen Sie das Debuggen an Funktionseinstiegspunkten oder Hauptausführungspfaden

• Dem Ausführungsfluss folgen: Verwenden Sie die schrittweise Ausführung, um den Codefluss zu verstehen

• Ursachenanalyse: Bleiben Sie nicht bei Symptomen stehen – finden Sie die zugrunde liegende Ursache

🛡️ Sicherheit & Zuverlässigkeit

• Sichere Kommunikation: Alle MCP-Kommunikationen verwenden sichere Protokolle

• Lokaler Betrieb: Der MCP-Server läuft zu 100 % lokal ohne externe Kommunikation und erfordert keine Anmeldeinformationen

• Zustandsvalidierung: Robuste Validierung von Debug-Zuständen und -Operationen

Installation

Schnellinstallationsoptionen

Option 1: Direkter Link (Schnellste)

• Klicken Sie auf diesen Link: vscode:extension/ozzafar.debugmcpextension

• Oder kopieren und fügen Sie in Ihren Browser ein: vscode:extension/ozzafar.debugmcpextension

Option 2: VS Code Marketplace

• Besuchen Sie: https://marketplace.visualstudio.com/items?itemName=ozzafar.debugmcpextension

• Klicken Sie auf "Installieren"

Option 3: Innerhalb von VS Code

1. Öffnen Sie VSCode

2. Gehen Sie zu Erweiterungen (Ctrl+Shift+X / Cmd+Shift+X)

3. Suchen Sie nach "DebugMCP"

4. Klicken Sie auf Installieren

5. Die Erweiterung aktiviert sich automatisch und registriert sich als MCP-Server

Überprüfung

Nach der Installation sollten Sie Folgendes sehen:

• DebugMCP-Erweiterung in Ihren installierten Erweiterungen

• MCP-Server, der automatisch auf Port 3001 läuft (konfigurierbar)

• Debug-Werkzeuge, die für verbundene KI-Assistenten verfügbar sind

📝 Hinweis: Es sind keine zusätzlichen Debugging-Regelanweisungen erforderlich – die Erweiterung funktioniert sofort.

💡 Tipp: Aktivieren Sie die automatische Genehmigung für alle debugmcp-Werkzeuge in Ihrem KI-Assistenten, um nahtlose Debugging-Workflows ohne ständige Genehmigungsunterbrechungen zu erstellen.

Schnellstart

1. Installieren Sie die Erweiterung (siehe Installation)

2. Öffnen Sie Ihr Projekt in VSCode

3. Bitten Sie Ihre KI zu debuggen – sie kann jetzt Breakpoints setzen, das Debuggen starten und Ihren Code analysieren!

Unterstützte KI-Assistenten

DebugMCP funktioniert mit jedem MCP-kompatiblen KI-Assistenten. Es erkennt automatisch und bietet an, sich selbst zu registrieren mit:

Unterstützte Sprachen

DebugMCP unterstützt das Debugging für die folgenden Sprachen mit den jeweiligen VSCode-Erweiterungen:

Konfiguration

MCP-Server-Konfiguration (Empfohlen)

Die Erweiterung führt automatisch einen MCP-Server aus. Es erscheint eine Meldung, die anbietet, den MCP-Server in Ihrem KI-Assistenten automatisch zu registrieren.

Sie können die Registrierung auch manuell über die Befehlspalette auslösen:

• DebugMCP: Show Agent Selection Popup

Manuelle MCP-Server-Registrierung (Optional)

🔄 Automatische Migration: Wenn Sie DebugMCP zuvor mit SSE-Transport konfiguriert haben, migriert die Erweiterung Ihre Konfiguration bei der Aktivierung automatisch auf den neuen Streamable-HTTP-Transport.

Cline

Fügen Sie dies zu Ihren Cline-Einstellungen oder cline_mcp_settings.json hinzu:

{
  "mcpServers": {
    "debugmcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "description": "DebugMCP - AI-powered debugging assistant"
    }
  }
}

GitHub Copilot

Fügen Sie dies zu Ihren VS-Code-Einstellungen (settings.json) hinzu:

{
  "mcp": {
    "servers": {
      "debugmcp": {
        "type": "http",
        "url": "http://localhost:3001/mcp",
        "description": "DebugMCP - Multi-language debugging support"
      }
    }
  }
}

GitHub Copilot CLI

Fügen Sie dies zu ~/.copilot/mcp-config.json hinzu (${COPILOT_HOME}/mcp-config.json, wenn COPILOT_HOME gesetzt ist):

{
  "mcpServers": {
    "debugmcp": {
      "type": "http",
      "url": "http://localhost:3001/mcp",
      "tools": ["*"]
    }
  }
}

Cursor

Fügen Sie dies zu den MCP-Einstellungen von Cursor hinzu:

{
  "mcpServers": {
    "debugmcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "description": "DebugMCP - Debugging tools for AI assistants"
    }
  }
}

Codex

Registrieren Sie DebugMCP bei Codex:

codex mcp add debugmcp --url http://localhost:3001/mcp

Oder fügen Sie die entsprechende Konfiguration zu ~/.codex/config.toml hinzu (${CODEX_HOME}/config.toml, wenn CODEX_HOME gesetzt ist):

[mcp_servers.debugmcp]
url = "http://localhost:3001/mcp"

Windsurf

Fügen Sie dies zu den MCP-Einstellungen von Windsurf hinzu (~/.windsurf/mcp_settings.json oder .windsurf/mcp_settings.json im Arbeitsbereich):

{
  "mcpServers": {
    "debugmcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "description": "DebugMCP - Debugging tools for AI assistants"
    }
  }
}

Roo Code

Fügen Sie dies zu den MCP-Einstellungen von Roo Code hinzu:

{
  "mcpServers": {
    "debugmcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "description": "DebugMCP - Debugging tools for AI assistants"
    }
  }
}

Antigravity

Fügen Sie dies zu den MCP-Einstellungen von Antigravity hinzu:

{
  "mcpServers": {
    "debugmcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "description": "DebugMCP - Debugging tools for AI assistants"
    }
  }
}

Erweiterungseinstellungen

Konfigurieren Sie das Verhalten von DebugMCP in den VSCode-Einstellungen:

{
  "debugmcp.serverPort": 3001,
  "debugmcp.timeoutInSeconds": 180,
  "debugmcp.bindHost": ["127.0.0.1", "::1"]
}

Sicherheitsmodell

DebugMCP stellt leistungsstarke Debugger-Primitive (evaluate_expression, start_debugging, …) über einen nicht authentifizierten lokalen HTTP-Endpunkt bereit. Um diese Oberfläche sicher zu halten, erzwingt der Server vier Kontrollen:

1. Nur Loopback-Bindung. Der HTTP-Server bindet standardmäßig an die IPv4- und IPv6-Loopback-Adressen (127.0.0.1 und ::1), sodass andere Hosts in Ihrem Netzwerk http://<your-ip>:3001/mcp nicht erreichen können. Die Bindung an beide Adressfamilien stellt sicher, dass Clients, die localhost in eine der beiden Familien auflösen, eine Verbindung herstellen können. Die Einstellung debugmcp.bindHost (String oder Array von Strings) ermöglicht es Ihnen, eine andere Schnittstelle zu wählen (z. B. beim Weiterleiten des Ports in einen Remote-Container). Dadurch wird der nicht authentifizierte Debugger jedoch für alles erreichbar, was diese Adresse ansteuern kann – richten Sie ihn nicht auf 0.0.0.0 oder eine LAN-Adresse in einem nicht vertrauenswürdigen Netzwerk.

2. Host-/Origin-Header-Validierung. Jede Anfrage muss einen Host-Header mit einer Loopback-Adresse (localhost, 127.0.0.1 oder [::1]) enthalten; ein Port-Suffix im Host muss ebenfalls mit dem Abhörport des Servers übereinstimmen. Anfragen mit einem anderen Host – einschließlich solcher, die über DNS-Rebinding von einer bösartigen Webseite eintreffen – werden mit HTTP 403 abgelehnt. Dieselbe Loopback-Prüfung wird auf den Origin-Header angewendet, sofern vorhanden.

3. Variablenprüfung mit minimalen Rechten. get_variables_values erfordert eine explizite variableNames-Liste (max. 50, keine Platzhalter) und gibt nur diese Variablen zurück. Es werden nicht mehr alle Variablen im Gültigkeitsbereich ausgegeben, wodurch der Agent zuvor unaufgefordert irrelevanten Prozessstatus erhielt. Verwenden Sie list_variable_names, um herauszufinden, was existiert; dieses Tool gibt nur Namen und Typen zurück und liest niemals einen Wert.

4. Schwärzung von Geheimnissen bei der Variablenprüfung. Werte mit anmeldeinformationsähnlichen Namen oder Werten, die einer bekannten Anmeldeinformationsform entsprechen, werden durch <redacted: possible secret> ersetzt, bevor die Antwort die Erweiterung verlässt. Das von evaluate_expression zurückgegebene ausgewertete Ergebnis ist ebenfalls abgedeckt. Wenn get_variables_values oder evaluate_expression einen komplexen Wert erweitert, werden Nachfolger nur nach Name und Typ aufgelistet. Verwenden Sie evaluate_expression mit einem exakten Nachfolgerpfad, wenn dessen Wert benötigt wird. Die rekursive Erweiterung ist auf insgesamt 100 untergeordnete Felder pro Antwort begrenzt. Null-ähnliche Werte (None, undefined, '') werden niemals geschwärzt, sodass Fehler wie „mein Token ist leer" debugbar bleiben. Die Schwärzung ist immer aktiviert und kann nicht deaktiviert werden.

FAQ

DebugMCP funktioniert mit jedem MCP-kompatiblen KI-Assistenten, einschließlich GitHub Copilot, GitHub Copilot CLI, Cline, Cursor, Codex, Windsurf, Roo Code, Antigravity und anderen. Wenn Ihr Assistent das Model Context Protocol unterstützt, kann er DebugMCP verwenden.

Ja. DebugMCP läuft als VS-Code-Erweiterung mit extensionKind: workspace, sodass es in der Remote-Umgebung aktiviert wird, in der sich Ihr Code befindet. Der MCP-Server läuft auf localhost in diesem Remote-Kontext.

Nein. DebugMCP generiert automatisch geeignete Debug-Konfigurationen basierend auf der Sprache/Dateierweiterung der Datei. Wenn Sie eine launch.json haben, wird automatisch die relevanteste Konfiguration ausgewählt.

Nein. DebugMCP läuft zu 100 % lokal. Der MCP-Server läuft auf localhost, und es werden keine Code-, Variablen- oder Debug-Daten an einen externen Dienst gesendet. Der KI-Assistent kommuniziert vollständig innerhalb Ihres lokalen Rechners mit dem MCP-Server.

Ändern Sie den Port in den VS-Code-Einstellungen: "debugmcp.serverPort": 3002 (oder einen beliebigen verfügbaren Port). Aktualisieren Sie dann die MCP-Konfiguration Ihres KI-Assistenten, um den neuen Port zu verwenden.

Ja. Übergeben Sie den Parameter testName an start_debugging, um eine bestimmte Testmethode zu debuggen. DebugMCP konfiguriert die Debug-Sitzung so, dass sie ausgeführt wird und an Haltepunkten innerhalb dieses Tests anhält.

Stellen Sie sicher, dass DebugMCP in den MCP-Einstellungen Ihres KI-Assistenten registriert ist. Die Erweiterung sollte sich automatisch erkennen und zur Registrierung anbieten. Wenn nicht, lesen Sie den Abschnitt Manuelle MCP-Server-Registrierung. Aktivieren Sie außerdem die automatische Genehmigung für DebugMCP-Tools für einen reibungsloseren Arbeitsablauf.

Ja. DebugMCP unterstützt .cs-Dateien und .csproj-Projektdateien für C#/.NET-Debugging, einschließlich ASP.NET-Anwendungen.

Fehlerbehebung

Häufige Probleme

MCP-Server startet nicht

• Symptom: Der KI-Assistent kann keine Verbindung zu DebugMCP herstellen

• Lösung:

  • Prüfen Sie, ob Port 3001 verfügbar ist

  • Starten Sie VSCode neu

  • Stellen Sie sicher, dass die Erweiterung installiert und aktiviert ist

Debug-Sitzung hält an Haltepunkten nicht an

• Symptom: Haltepunkte sind gesetzt, aber die Ausführung pausiert nicht

• Lösung:

  • Stellen Sie sicher, dass die richtige Datei debuggt wird

  • Prüfen Sie, ob die Zeilennummer des Haltepunkts korrekt ist

  • Stellen Sie sicher, dass die relevante Sprach-Debugger-Erweiterung installiert ist

Ein anderes VS-Code-Fenster erhält den Fokus, wenn das Debugging stoppt

• Symptom: Bei mehreren geöffneten VS-Code-Fenstern kommt das debuggte Fenster in den Vordergrund, wenn es einen Haltepunkt erreicht oder einen Schritt abschließt

• Lösung: Deaktivieren Sie das native Fokus-beim-Haltepunkt-Verhalten von VS Code in Ihren Benutzer- oder Arbeitsbereichseinstellungen:

  {
    "debug.focusWindowOnBreak": false,
    "debug.focusEditorOnBreak": false
  }

  debug.focusWindowOnBreak verhindert, dass das debuggte Fenster den Fokus des Betriebssystems erhält. Die optionale Einstellung debug.focusEditorOnBreak verhindert außerdem, dass VS Code den Fokus in den angehaltenen Quellcode-Editor verschiebt. DebugMCP ändert diese persistenten Einstellungen nicht automatisch.

Konfiguration wird nicht automatisch erkannt

• Symptom: Die Erweiterung fordert nicht zur Registrierung bei Ihrem KI-Assistenten auf

• Lösung:

  • Führen Sie DebugMCP: Show Agent Selection Popup aus der Befehlspalette aus (Ctrl+Shift+P / Cmd+Shift+P)

  • Fügen Sie die Konfiguration manuell hinzu (siehe Manuelle MCP-Server-Registrierung)

So funktioniert es

Architektur

AI Agent (Copilot/Cline/Cursor/Codex) → MCP/Streamable HTTP → DebugMCPServer → DebuggingHandler → VS Code Debug API

Integration der Startkonfiguration

Die Erweiterung behandelt Debug-Konfigurationen intelligent:

• Vorhandene launch.json: Wenn eine Datei .vscode/launch.json vorhanden ist, wird sie:

  • Nach einer relevanten Konfiguration suchen

  • configurationName berücksichtigen, wenn es vom Agenten explizit angegeben wird

  • JSONC unterstützen (JSON mit Kommentaren und nachgestellten Kommas)

• Standardkonfiguration: Wenn configurationName weggelassen wird oder keine passende benannte Konfiguration gefunden wird, erstellt sie eine geeignete Standardkonfiguration für jede Sprache basierend auf der Erkennung der Dateierweiterung.

Anforderungen

• VSCode mit den entsprechenden Spracherweiterungen installiert:

  • Python: Python-Erweiterung für .py-Dateien

  • JavaScript/TypeScript: Integrierter Node.js-Debugger oder JavaScript-Debugger-Erweiterung

  • Java: Erweiterungspaket für Java

  • C#/.NET: C#-Erweiterung

  • C/C++: C/C++-Erweiterung

  • Go: Go-Erweiterung

  • Rust: rust-analyzer-Erweiterung

  • PHP: PHP-Debug-Erweiterung

  • Ruby: Ruby-Erweiterung mit Debug-Unterstützung

• MCP-kompatibler KI-Assistent (Copilot, Cline, Cursor, Codex, Windsurf, Roo Code usw.)

Entwicklung

Zum Erstellen der Erweiterung:

npm install
npm run compile

Zum Ausführen von Linting:

npm run lint

Zum Ausführen von Tests:

npm test

Mitwirken

Dieses Projekt begrüßt Beiträge und Vorschläge. Die meisten Beiträge erfordern, dass Sie einer Contributor License Agreement (CLA) zustimmen, die bestätigt, dass Sie das Recht haben, uns die Rechte zur Nutzung Ihres Beitrags zu gewähren, und dies auch tatsächlich tun. Einzelheiten finden Sie unter https://cla.opensource.microsoft.com.

Wenn Sie einen Pull-Request einreichen, wird ein CLA-Bot automatisch feststellen, ob Sie eine CLA bereitstellen müssen, und den PR entsprechend kennzeichnen (z. B. Statusprüfung, Kommentar). Befolgen Sie einfach die Anweisungen des Bots. Sie müssen dies nur einmal für alle Repos tun, die unsere CLA verwenden.

Dieses Projekt hat den Microsoft Open Source Code of Conduct übernommen. Weitere Informationen finden Sie in den Code of Conduct FAQ oder wenden Sie sich bei weiteren Fragen oder Kommentaren an opencode@microsoft.com.

Sicherheit

Sicherheitslücken sollten gemäß den Anweisungen unter https://aka.ms/SECURITY.md gemeldet werden. Bitte melden Sie Sicherheitslücken nicht über öffentliche GitHub-Issues.

Marken

Dieses Projekt kann Marken oder Logos für Projekte, Produkte oder Dienste enthalten. Die autorisierte Nutzung von Microsoft-Marken oder -Logos unterliegt den Microsoft Trademark & Brand Guidelines und muss diesen entsprechen. Die Verwendung von Microsoft-Marken oder -Logos in modifizierten Versionen dieses Projekts darf keine Verwirrung stiften oder eine Microsoft-Förderung implizieren. Jegliche Verwendung von Marken oder Logos Dritter unterliegt den Richtlinien dieser Dritten.

⭐ DebugMCP unterstützen

Wenn DebugMCP Ihnen geholfen hat, schneller zu debuggen, ziehen Sie bitte in Betracht, ihm auf GitHub einen Stern zu geben! Sterne helfen dem Projekt, Sichtbarkeit zu erlangen und Mitwirkende anzuziehen.

⭐ DebugMCP auf GitHub einen Stern geben

Sternenverlauf

Lizenz

MIT-Lizenz – Siehe LICENSE für Details

Diese Erweiterung wurde von Oz Zafar, Ori Bar-Ilan und Karin Brisker erstellt.