VS Code 调试工具 for Copilot

一个通过本地 MCP 服务向 Copilot Chat 暴露断点和调试工作台工具的 VS Code 扩展。

功能与使用

注册本地 MCP 服务 VS Code Debug Tools for Copilot
通过 Copilot 管理当前工作区的断点和调试工作台
提供诊断、配置导出和多工作区支持
支持 TypeScript 开发，并包含完整的测试和代码检查配置

扩展用法

1. 安装与配置

安装扩展后，首次使用需要配置 AI agent：

按 Ctrl+Shift+P 打开命令面板
输入 "Configure AI Agent MCP" 并执行
在弹出的选择框中勾选要配置的 agent（Cline、Cursor）
点击确定，扩展会自动修改相应配置文件
之后每次启动时，扩展会自动刷新已经配置过的客户端到当前 MCP endpoint
需要查看当前 MCP endpoint、代理配置和调试状态时，可以直接执行 "Show MCP Diagnostics"
如果要给其他兼容 MCP 的客户端生成可复用的配置片段，可以执行 "Export MCP Configuration"

Copilot skill 也随扩展提供，用来帮助 Copilot 选择正确的断点和调试工具：

Breakpoint MCP Tools Guide

这部分面向 Copilot 的工具选择和参数规则；用户的安装、配置和使用说明都集中在本页。

2. 在 Copilot 中使用断点工具

配置完成后，您可以在 Copilot Chat 中使用以下断点管理功能：

查看断点：询问 Copilot "列出当前工作区的所有断点"
添加断点：询问 Copilot "在第10行添加断点" 或 "在函数foo处添加断点"
删除断点：询问 Copilot "删除第10行的断点"
启用/禁用断点：询问 Copilot "禁用第10行的断点"
调试控制：询问 Copilot "开始调试" 或 "单步执行"

3. 支持的工具列表

扩展提供完整的断点和调试工具集，详细说明请参考：

4. 启动配置与多工作区

start_debug_launch_configuration 支持多工作区场景下的配置选择。

如果只打开了一个 workspace folder，可以直接按 launchName 或原始 launchConfiguration 启动。
如果同时打开了多个 workspace folder，且不同根目录里存在同名的 launch 配置，需要额外传入 workspaceFolderPath 来指定目标工作区。
list_debug_launch_configurations 也支持传入 workspaceFolderPath，只查看某一个工作区文件夹下的 launch.json 配置。

开发环境要求

Node.js 20.x 或更高版本
VS Code 1.115.0 或更高版本

编译与运行

安装依赖

在项目根目录下执行：
```
npm install
```
编译 TypeScript 代码
```
npm run compile
```
或使用监听模式自动编译：
```
npm run watch
```
在 VS Code 中调试插件
- 活动编辑器聚焦入口文件(一般是 src/extension.ts)或者编译输出的js文件(out/extension.js)，按 F5 启动插件调试，会自动打开一个新的 VS Code 窗口加载本插件。（通过js文件调试时，需要选择vscode 扩展开发调试器）
测试插件功能

在新打开的 VS Code 窗口中：
- 按 Ctrl+Shift+P 打开命令面板
- 输入 "显示欢迎消息" 并执行
- 应该看到弹出的欢迎信息
代码检查
```
npm run lint
```
运行测试
```
npm test
```

项目结构

├── src/
│   └── extension.ts          # 插件主入口文件
├── out/                      # 编译输出目录
├── package.json             # 项目配置和依赖
├── tsconfig.json            # TypeScript 配置
└── README.md                # 项目说明文档

打包与发布

安装 vsce 工具
```
npm install -g vsce
```
打包插件
```
vsce package
```
发布到市场
```
vsce publish
```

开发提示

修改代码后需要重新编译才能在调试窗口中看到更改
可以使用 npm run watch 监听文件变化自动编译
调试时可以在代码中设置断点进行调试

VS Code Debug Tools for Copilot

fangfuzha