microsoft/DebugMCP

Gift your VS Code agent a real debugger: breakpoints, stepping, inspection.

453 ★48 forksTypeScriptUpdated 1d ago

What you need to know

A VS Code extension + MCP server that gives AI coding agents full control over the VS Code debugger — set breakpoints, step through code, inspect variables, and evaluate expressions. Runs 100% locally with zero config.

Install

Install from VS Code Marketplace (vscode:extension/ozzafar.debugmcpextension) or search 'DebugMCP' in VS Code extensions
The extension auto-registers itself as an MCP server with supported AI assistants (port 3001)

Usage

  • Install the extension, open your project in VS Code, then ask your AI to debug (e.g. 'set a breakpoint and step through this')
  • Enable auto-approval for debugmcp tools in your assistant for a seamless workflow
  • Manual registration example (Cline/Cursor/Windsurf/Roo Code/Antigravity): `{"mcpServers": {"debugmcp": {"type": "streamableHttp", "url": "http://localhost:3001/mcp"}}}`
  • Codex: `codex mcp add debugmcp --url http://localhost:3001/mcp`

Key features

  • 15 tools: start_debugging, step_over/into/out, continue_execution, pause_execution, add_breakpoint/add_logpoint, remove/clear/list breakpoints, list_variable_names, get_variables_values, evaluate_expression
  • Auto-generates debug configurations from the file's language (no launch.json needed); testName param debugs individual unit tests via the VS Code Testing API
  • 'debug-live' Agent Skill installed to standard skills directories (~/.agents/skills/, ~/.copilot/skills/)
  • 100% local, no credentials, no external communication; works over Remote SSH / Codespaces / WSL
  • Security model: loopback-only bind, Host/Origin validation, least-privilege variable inspection, always-on secret redaction

Best for

AI-assisted debugging in VS Code where the agent needs real breakpoints, stepping, and variable inspection (any MCP-capable assistant, multi-language).

Caveats

  • Requires VS Code and the language-specific debugger extension for each language (Python, C/C++, Java, Go, Rust, PHP, Ruby, C#/.NET, JS/TS)
  • Exposes powerful unauthenticated debug primitives on a local HTTP endpoint — binds to loopback only; do not bind to 0.0.0.0/LAN on untrusted networks
  • Secret redaction is best-effort: credentials nested inside rendered containers (structs) are not scrubbed entry-by-entry
  • Breakpoints may be missed if the wrong file/debugger extension is active; MCP server must be registered in the assistant's settings
Platforms: Windows · macOS · Linux · VS Code Remote SSH / Codespaces / WSLClients: Codex · GitHub Copilot · GitHub Copilot CLI · Cline · Cursor · Windsurf · Roo Code · Antigravity

Reviewed 2026-08-07

Topics

ai-agentai-debuggingbreakpointscopilotcursordebuggerllmmcpmodel-context-protocolvscode-extension
View on GitHub ↗
Stars
453★
Forks
48
Language
TypeScript
License
MIT
Created
2025-09-30
Last push
2026-08-05