README.md•3.31 kB
# VS Code Debugger MCP Server Proxy
This proxy acts as a bridge, enabling AI assistants that communicate via `stdio` to connect to the **VS Code Debugger MCP Server**, which uses `HTTP` or `SSE`.
---
## Why Use This Proxy?
This tool is essential if your AI assistant does not support direct `HTTP` or `SSE` connections and requires a `stdio`-based server to interact with the VS Code debugger. It translates the `stdio` communication from your AI tool into a format the main debugger extension can understand.
---
## Supercharge Your AI with the Main Extension
This proxy is a companion to the **VS Code Debugger MCP Server** extension. The main extension is what gives your AI its debugging superpowers.
[**Install it from the VS Code Marketplace**](https://marketplace.visualstudio.com/items?itemName=rauschit.vscode-debugger-mcp-server)
---
## Prerequisites
Before you begin, ensure you have the following installed:
1. **Node.js and npm:** [Download and install Node.js](https://nodejs.org/).
2. **VS Code Debugger MCP Server:** Install the main extension from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=rauschit.vscode-debugger-mcp-server).
---
## Important: Extension Settings
**To use this proxy, you must set the transport type of the VS Code Debugger MCP Server extension to "websocket" in the extension's settings in VS Code.**
1. Open VS Code.
2. Go to **Settings** (`Ctrl+,`).
3. Search for **VSCode Debugger MCP Server**.
4. Set the **Transport Type** to `websocket`.
---
## Installation and Build
Follow these steps to get the proxy up and running:
1. **Clone the repository:**
```bash
git clone https://github.com/your-username/vscode-debugger-mcp-server-proxy.git
cd vscode-debugger-mcp-server-proxy
```
2. **Install dependencies:**
```bash
npm install
```
3. **Build the project:**
```bash
npm run build
```
This will compile the TypeScript source code into JavaScript in the `dist` directory.
---
## Configuration
To connect your AI assistant, you need to configure it to use this proxy. Here is an example configuration for Roo Code:
### Stdio MCP Server Config for Roo Code
Add the following to your Roo Code settings:
```json
{
"mcpServers": {
"vscode-debugger": {
"command": "node",
"args": [
"d:/Projekte/MCP/vscode-debugger-mcp-server-proxy/dist/index.js",
"-p",
"10101"
],
"env": {
"DEBUG": "false"
},
"disabled": false,
"type": "stdio"
}
}
}
```
**Important:** Make sure the path in the `args` array is the absolute path to the compiled `index.js` file on your system.
**Note:** The port number (`10101` in the example above) must match the port configured and **Transport Type** is set to `websocket` in the VS Code Debugger MCP Server extension settings. Ensure both the proxy and the extension are set to use the same port for successful communication.
---
## How It Works
The proxy sits between your AI assistant and the main debugger extension, translating communication between them.
<p align="center">
<img src="docs/workflow.png" alt="Workflow Diagram" width="500"/>
</p>
---
## License
This project is open source and licensed under the [MIT License](./LICENSE).