项目简介

MCP调试中心是一个强大的VS Code扩展，旨在桥接AI编程助手与VS Code的调试功能。它依据Model Context Protocol (MCP) 标准构建，允许人工智能客户端（如Cursor, Cline, Continue等）直接与您的VS Code调试会话进行交互。这意味着AI可以执行启动/停止调试、设置断点、单步调试、检查变量和调用堆栈等操作，极大地增强了AI在代码调试和理解方面的能力。

主要功能点

调试会话管理： 允许AI编程助手启动新的调试会话、停止现有会话、附加到正在运行的进程，并全面管理VS Code中的调试会话。它还支持多进程调试，能够处理父子进程的调试关系。
断点管理： 提供给AI设置、移除和列出工作区内所有断点的能力。支持设置带有条件、命中次数和日志消息的高级断点。
代码执行控制： AI可以控制代码的执行流程，包括继续执行直到下一个断点、暂停当前运行、单步跳过当前行、单步进入函数以及单步跳出当前函数。
运行时检查： 允许AI在调试会话暂停时评估表达式、检查当前作用域内的变量值、获取调用堆栈信息，并确定程序当前的精确执行位置。
智能上下文检测： 在执行检查操作时，会自动利用VS Code调用堆栈视图中当前选定的帧作为上下文，简化AI的操作。
多语言兼容： 与VS Code调试适配器支持的任何编程语言无缝协作，提供通用的调试接口。
内置状态视图： VS Code活动栏中提供一个直观的视图，用于监控MCP服务器的状态、活跃连接和关键指标，并提供方便的服务器控制快捷操作。

安装步骤

环境要求：
- 您需要安装 VS Code 版本 1.99.0 或更新。
- Node.js 版本 v22.x 或更新。
- 您的VS Code工作区必须包含至少一个调试配置（通常在 '.vscode/launch.json' 文件中定义）。

安装扩展：

从VS Code Marketplace安装（推荐）： 打开VS Code，进入扩展视图（侧边栏的方块图标），搜索 “MCP Debug Hub” 并点击安装。

从源代码安装： 如果您希望从源代码构建和安装，请执行以下步骤：

# 克隆仓库
git clone https://github.com/R-D-menasheof/mcp-debug-hub.git
cd mcp-debug-hub
# 安装依赖
npm install
# 构建VSIX安装包
npm run vsix
# 在VS Code中安装VSIX文件
code --install-extension dist/mcp-debug-hub.vsix

服务器配置

MCP调试中心作为Model Context Protocol (MCP) 服务器运行，您的AI客户端需要配置才能与其建立连接。默认情况下，服务器将在 'http://localhost:37337/mcp' 地址上通过Server-Sent Events (SSE) 协议监听客户端请求。您可以根据您使用的AI客户端类型进行如下配置：

Cursor 客户端配置示例： 请编辑您的Cursor客户端配置文件（通常是 '~/.cursor/mcp.json'），或通过Cursor的设置界面进行配置：

{
  "mcpServers": {
    "debug-mcp": {
      "url": "http://localhost:37337/mcp"
    }
  }
}

'debug-mcp': 您为这个MCP服务器定义的唯一名称。
'url': MCP调试中心服务器的访问地址。

Cline 客户端配置示例： 请参考Cline的MCP文档，并在其配置中添加以下内容：

{
  "mcpServers": {
    "debug-mcp": {
      "command": "node",
      "args": [],
      "transport": {
        "type": "sse",
        "url": "http://localhost:37337/mcp"
      }
    }
  }
}

'debug-mcp': 您为这个MCP服务器定义的唯一名称。
'command': 如果MCP客户端需要自行启动一个外部进程作为MCP服务器，这里指定启动命令。由于MCP调试中心是VS Code扩展，此字段通常可留空或使用占位符。
'args': 启动命令的参数列表。
'transport': 定义客户端与服务器通信的协议类型。
- 'type': 通信协议类型，这里是 'sse'（Server-Sent Events）。
- 'url': MCP调试中心服务器的访问地址。

Continue 客户端配置示例： 请编辑您的Continue客户端配置文件（通常是 '~/.continue/config.json'）：

{
  "mcpServers": {
    "debug-mcp": {
      "transport": {
        "type": "sse",
        "url": "http://localhost:37337/mcp"
      }
    }
  }
}

'debug-mcp': 您为这个MCP服务器定义的唯一名称。
'transport': 定义客户端与服务器通信的协议类型。
- 'type': 通信协议类型，这里是 'sse'。
- 'url': MCP调试中心服务器的访问地址。

修改服务器端口和主机： 您可以在VS Code的设置中修改 'mcpDebugHub.ssePort' 和 'mcpDebugHub.sseHost' 来更改服务器监听的端口和主机地址。如果更改，请确保您的AI客户端配置也随之更新。

基本使用方法

启动MCP服务器：
- 如果您在VS Code设置中启用了 'mcpDebugHub.autostart' 选项，MCP服务器将在VS Code启动时自动运行。
- 否则，您可以手动启动：在VS Code的活动栏中找到“MCP Debug Hub”视图（一个层叠的图标），点击其中的“Start”按钮；或者使用VS Code的命令面板（'Ctrl+Shift+P'），然后输入并选择 'MCP Debug Hub: Start' 命令。
准备调试配置： 确保您的VS Code工作区内有一个有效的调试配置文件（例如，位于 '.vscode/launch.json'），其中定义了您想要调试的程序的启动或附加配置。
通过AI客户端进行交互： 一旦MCP服务器运行并配置好您的AI客户端，您就可以开始通过AI发送调试指令。例如，在您的AI客户端中输入以下提示：
```
Launch the debug configuration "Python: Current File" and set a breakpoint at line 10 of main.py
```
您的AI客户端将通过MCP调试中心与VS Code通信，自动启动“Python: Current File”调试配置，并在 'main.py' 文件的第10行设置一个断点。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息