DebugMCP (MCP Server) - Empowering AI Agents with Multi-Language Debugging Capabilities

Let AI agents debug your code inside VS Code — set breakpoints, step through execution, inspect variables, and evaluate expressions. Works with GitHub Copilot, Cline, Cursor, and any MCP-compatible assistant. Supports Python, JavaScript/TypeScript, Java, C#, C++, Go, Rust, PHP, and Ruby.

📢 Beta Version Notice: This is a beta version of DebugMCP maintained by ozzafar@microsoft.com and orbarila@microsoft.com. We welcome feedback and contributions to help improve this extension.

Watch DebugMCP in action — your AI assistant autonomously sets breakpoints, steps through code, and inspects variables directly in VS Code.

🚀 Quick Install

Install from VS Code Marketplace or use the direct link: vscode:extension/ozzafar.debugmcpextension

Table of Contents

• Overview
• Features
• Installation
• Quick Start
• Supported Languages
• Configuration
• Troubleshooting
• Contributing
• License

Overview

DebugMCP is an MCP server that gives AI coding agents full control over the VS Code debugger. Instead of reading logs or guessing, your AI assistant can autonomously set breakpoints, launch debug sessions, step through code line by line, inspect variable values, and evaluate expressions — just like a human developer would. It runs 100% locally, requires zero configuration, and works out of the box with any MCP-compatible AI assistant.

Features

🔧 Tools

| Tool | Description | Parameters | |------|-------------|------------| | get_debug_instructions | Get the debugging guide with best practices and workflow instructions | None | | start_debugging | Start a debug session for a source code file | fileFullPath (required)<br>workingDirectory (required)<br>testName (optional)<br>configurationName (optional) | | stop_debugging | Stop the current debug session | None | | step_over | Execute the next line (step over function calls) | None | | step_into | Step into function calls | None | | step_out | Step out of the ...