项目简介

Debugssy 是一个创新的 VS Code 扩展，它将你的 VS Code 调试器转变为一个 Model Context Protocol (MCP) 服务器。这意味着你可以通过任何兼容 MCP 的 AI 编程助手（如 Cursor, GitHub Copilot Chat, Claude Desktop 等）使用自然语言来控制和理解调试过程，从而极大提高调试效率。

主要功能点

智能断点: AI 可根据代码和问题描述智能设置断点。
变量检查: AI 可读取变量值并解释其含义。
调用堆栈分析: AI 可分析调用堆栈，帮助理解代码执行路径。
执行控制: 在完全自动化模式下，AI 可控制调试器的步进、继续、暂停和重启等操作。
上下文资源: 将 VS Code 的调试配置（如 'launch.json'）作为 MCP 资源暴露，供 AI 读取。
调试工作流提示: 提供预设的 MCP Prompt 模板，指导 AI 进行特定调试任务（如调试崩溃、变量追踪、函数检查等）。
安全本地部署: MCP 服务器仅在本地 '127.0.0.1' 运行，并通过 Origin 头部和协议版本验证确保安全。

安装步骤

安装 Debugssy 扩展:
- 在 VS Code 扩展市场中搜索 "Debugssy" 并安装，或直接访问 VS Code Marketplace。
- (可选) 对于 VSCodium, Gitpod 等，可在 Open VSX 安装。
启动 Debugssy MCP 服务器:
- Debugssy 扩展安装并启用后，其 MCP 服务器默认会在 'http://localhost:3000/mcp' 自动启动。
- 你也可以在 VS Code 命令面板（'Ctrl+Shift+P' 或 'Cmd+Shift+P'）中运行 'Debugssy: Start Server' 命令手动启动。

MCP 客户端配置

将以下配置添加到你的 AI 助手设置中，以便其连接到 Debugssy MCP 服务器。

Cursor 客户端: 手动添加到 '~/.cursor/mcp.json' 文件：

{
  "mcpServers": {
    "debugssy": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

注释：此配置将 Debugssy MCP 服务器注册到 Cursor，使其可以通过 'http://localhost:3000/mcp' 地址与 Debugssy 扩展通信。

GitHub Copilot Chat 客户端 (VS Code): 手动添加到 VS Code 'settings.json' 文件：

{
  "github.copilot.chat.mcp.servers": {
    "debugssy": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

注释：此配置将 Debugssy MCP 服务器注册到 GitHub Copilot Chat，使其可以通过 'http://localhost:3000/mcp' 地址与 Debugssy 扩展通信。

Claude Desktop 客户端: 手动添加到 '~/Library/Application Support/Claude/claude_desktop_config.json' (macOS) 或 '%APPDATA%\Claude\claude_desktop_config.json' (Windows) 文件：
```
{
  "mcpServers": {
    "debugssy": {
      "url": "http://localhost:3000/mcp"
    }
  }
}
```
注释：此配置将 Debugssy MCP 服务器注册到 Claude Desktop，使其可以通过 'http://localhost:3000/mcp' 地址与 Debugssy 扩展通信。
其他 MCP 兼容助手: 连接到 'http://localhost:3000/mcp'。

基本使用方法

在 VS Code 中打开你的代码项目。
启动调试会话（按 'F5'）。
在你的 AI 助手聊天界面中，描述遇到的 bug。AI 将利用 Debugssy 提供的工具和上下文，引导你进行调试、设置断点、检查变量或解释代码行为。
你可以输入 '/' 查看 Debugssy 提供的预设 Prompt 模板（如 '/debug-crash', '/trace-variable'），以启动更结构化的调试工作流。

关键词

项目简介

主要功能点

安装步骤

MCP 客户端配置

基本使用方法

信息