Skip to content

v0.1.3

Choose a tag to compare

View all tags
@github-actions github-actions released this 24 May 16:20
v0.1.3
51802d1

v0.1.3

Released 2026-05-24

Highlights

  • Initial release. Drive your VS Code debugger, launch configs, tasks, terminals, and debug console from AI assistants — over MCP (Claude Code, Cursor, Windsurf) or VS Code's Language Model Tools API (Copilot agent mode, no MCP setup needed).
  • Cross-window cluster — multiple VS Code windows share one MCP server. The leader window owns the HTTP endpoint; followers join over IPC. Discovery is by port probing (no lockfile).
  • Auto-updates from GitHub Releases. One-line installer, no marketplace needed.

Added

  • Streamable HTTP MCP server bound to 127.0.0.1:6736 by default.
  • Language Model Tools integration so Copilot agent mode can use the same capabilities without an MCP client. Write-y tools (start/stop debug, run/stop task, set/clear breakpoints, run in terminal, evaluate) confirm with the user before invoking; read-only tools run silently.
  • One-click installer for Claude Code. Workspace scope writes .mcp.json into the project (git-shared). User scope shells out to 'claude mcp add --scope user' so the registration lands in ~/.claude.json where Claude Code actually reads user-scope MCP from.
  • debug-mcp usage skill installed globally at ~/.claude/skills/debug-mcp/ regardless of MCP scope — skills are description-gated, so a global install only activates in debugging-relevant conversations. Teaches Claude to prefer launch.json + tasks over raw Bash, and to call list_workspaces / bind_workspace at the start of multi-window sessions.
  • Smart re-prompting — the install prompt fires whenever the current workspace isn't configured AND user scope isn't configured. Picking 'Don't ask again' suppresses it permanently (until you run 'Reset Install Prompt'). Picking a scope and completing the install does NOT suppress prompts in other workspaces — opening a different repo with no .mcp.json will still prompt if you only configured workspace scope.
  • 'Debug MCP - Uninstall Claude Code Support…' command — multi-select picker to remove user-scope registration, current workspace .mcp.json entry, and/or the global skill.
  • Best-effort cleanup of the global skill on extension uninstall (deactivate hook).
  • Multi-window cluster — first VS Code window to start becomes the leader and owns the HTTP server; subsequent windows register as followers over a Unix socket. The leader exposes GET /cluster so new windows can discover it after port-probe.
  • list_workspaces and bind_workspace MCP tools so the AI can route tool calls to a specific window. Workspace ids are sha256(path).slice(0,12) — stable across restarts.
  • Launch tools — list_launch_configurations, start_debugging, stop_debugging, continue/pause/step_over/in/out.
  • Debug state tools — get_threads, get_stack_trace, get_scopes, get_variables, evaluate_expression.
  • Breakpoint tools — set/remove/toggle/clear, get_all_breakpoints, get_breakpoint.
  • Task tools — list_tasks, run_task, list_running_tasks, stop_task.
  • Terminal capture via shell-integration with read_terminal, list_terminals, clear_terminal_buffer, run_in_terminal.
  • Debug console capture via DebugAdapterTracker with read_debug_console, clear_debug_console_buffer, eval_in_debug_console.
  • GitHub-release auto-updater — checks every 6 hours, offers in-product install of the latest .vsix. Manual check via 'Debug MCP - Check for Updates'.
  • Status-bar menu with context-aware actions — install / reconfigure Claude Code, copy URL, start/stop, check for updates, open log. Status bar shows role: '(leader)', '(follower)', or unadorned for standalone.
  • Sample workspace under sample-workspace/ for end-to-end testing.
  • Leader failover — when the leader window closes, followers automatically retry the discovery flow and the next candidate naturally becomes the new leader.
  • Clear error message when the configured port is held by something other than Debug MCP, instead of a raw EADDRINUSE trace.
  • Architecture diagram + workspace-routing explanation in README.

Install the .vsix attached to this release via:

code --install-extension vscode-debug-mcp-0.1.3.vsix
Assets 4
Loading