VSCode Debugger MCP

This is a VS Code extension designed to enable AI agents to interact with VS Code’s debugging capabilities through a Model Context Protocol (MCP) server, achieving an automated and intelligent debugging experience. Assisted development using RooCode + Gemini 2.5 Pro.

✨ Features

• 🤖 AI-Driven Debugging:
  • Allows AI agents to perform standard VS Code debugging operations through the MCP tool interface.
  • Debug Configurations: Reads the project’s launch.json file to get available debug configurations.
  • Breakpoint Management: Set, remove, and query breakpoints, supporting regular breakpoints, conditional breakpoints, hit count breakpoints, and log points.
  • Execution Control: Start debugging sessions (launch or attach mode), continue execution (Continue), step through code (Step Over, Step Into, Step Out), and stop debugging sessions.
  • (Future) Inspect variable values, traverse the call stack, evaluate expressions in specific contexts, etc.
• ⚙️ MCP Server Management:
  • Status Bar Integration: Displays the real-time running status of the MCP server in the VS Code status bar (e.g., “Debug-MCP: Running” or “Debug-MCP: Stopped”).
  • Convenient Control: Click the status bar item to quickly start or stop the MCP server.
  • Port Configuration: Automatically detects port occupancy. If the default port is occupied, allows the user to manually specify a new port number, which will be persistently saved.
  • Auto Start: Configurable option to automatically start the MCP server when VS Code launches.
  • Client Configuration: Provides a one-click copy function to easily copy the configuration information (such as URL, port) required to connect to this MCP server to AI clients (e.g., ClaudeDesktop, RooCode, Cline, Cursor, etc.).
• 📡 Communication Protocol:
  • The VS Code extension communicates with the local MCP server via subprocess and IPC.
  • The MCP server communicates with AI clients using HTTP + Server-Sent Events (SSE), ensuring real-time and reliability.

🚀 Requirements

• Visual Studio Code: ^1.85.0 or higher.
• Node.js: ^18.0.0 or higher (for running the MCP server).
• How to Install Node.js: Please visit the Node.js official website to download and install the version suitable for your operating system.
• AI Client: An AI agent client that supports the Model Context Protocol.

📖 Usage Guide