VS Code Debugger MCP Server Proxy

此代理充当桥梁，使通过 stdio 进行通信的AI助手能够连接到使用 HTTP 或 SSE 的 VS Code Debugger MCP Server。

---

为什么使用这个代理？

如果你的AI助手不支持直接的 HTTP 或 SSE 连接，并且需要一个基于 stdio 的服务器来与VS Code调试器交互，那么这个工具是必不可少的。它将你的AI工具的 stdio 通信转换成主调试器扩展可以理解的格式。

---

使用主扩展增强你的AI

此代理是 VS Code Debugger MCP Server 扩展的伴侣。主扩展赋予了你的AI调试超级能力。

从VS Code Marketplace安装

---

先决条件

在开始之前，请确保已安装以下内容：

1. Node.js 和 npm: 下载并安装 Node.js
2. VS Code Debugger MCP Server: 从 VS Code Marketplace 安装主扩展。

---

重要：扩展设置

要使用此代理，必须在VS Code中的扩展设置中将VS Code Debugger MCP Server扩展的传输类型设置为“websocket”。

1. 打开VS Code。
2. 转到 设置 (Ctrl+,)。
3. 搜索 VSCode Debugger MCP Server。
4. 将 传输类型 设置为 websocket。

---

安装和构建

按照以下步骤操作以启动代理：

1. 克隆仓库：

   git clone https://github.com/your-username/vscode-debugger-mcp-server-proxy.git
   cd vscode-debugger-mcp-server-proxy
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

   这将把TypeScript源代码编译成JavaScript，并放置在 dist 目录下。

---

配置

为了连接你的AI助手，你需要将其配置为使用此代理。这里是一个Roo Code配置示例：

Roo Code的Stdio MCP Server配置

在你的Roo Code设置中添加以下内容：

{
  "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"
    }
  }
}

重要提示： 确保 args 数组中的路径是你系统上编译好的 index.js 文件的绝对路径。

注意： 端口号（上面示例中的 10101）必须与VS Code Debugger MCP Server扩展设置中配置的端口相匹配，并且 传输类型 必须设置为 websocket。确保代理和扩展都设置为使用相同的端口以实现成功通信。

---

工作原理

代理位于你的AI助手和主调试器扩展之间，负责它们之间的通信翻译。

<p align="center"> <img src="docs/workflow.png" alt="工作流程图" width="500"/> </p>

---

许可证

本项目是开源的，并根据 MIT许可证 授权。