debugssy (Gmaynez)

MCP开发工具

提供方 gmaynez

开发工具 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursorVS Code

Debugssy是一款连接AI助手与VS Code调试引擎的工具,通过自然语言指令实现自动化断点设置和代码检查,支持多种编程语言。

一句话选型结论

按资料字段整理

debugssy (Gmaynez) 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 19 仓库热度,无公开仓库时显示未标注
工具数 17 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量17暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI调试TypeScript本地部署VSCode扩展自动化工具编程辅助断点管理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 17 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 17 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
debugssy (Gmaynez)当前 17 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方gmaynez上游标注的维护方 gmaynez
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.6 KB
来自项目仓库与上游目录的原文,未做删改

调试

让你的AI助手驱动调试器。

Debugssy将AI助手(Cursor、Copilot、Claude Desktop)连接到VS Code的
通过调试引擎
模型上下文协议。而不是单击
通过调试器UI,描述您要查找的内容。

安装 ·
问题 · 安全


它的作用```

You: "Figure out why users get null when logging in"

AI: Sets breakpoint in auth handler → waits for hit → inspects user object →
traces call stack → spots missing WHERE clause in the query. Done.


AI获得了设置断点的工具(包括条件、点击次数、日志点),
通过MCP读取变量、遍历调用堆栈和计算表达式。
你保持控制 _当_ 调试运行或完全移交控制权。

适用于VS Code可以调试的任何语言:JavaScript、TypeScript、Python、,
Go、Java、C++、Rust,随便你怎么说。

**推荐型号:** 克劳德4.5俳句或格罗克4.1快速(速度+成本)。

______________________________________________________________________

## 快速开始

### 1.安装扩展

搜索 **“调试”** 在VS Code的扩展面板中(`Ctrl+Shift+X`),或者抓住它
发件人:

- VS代码市场
- 打开VSX (VSCodium、Gitpod、,
等等)

### 2.连接你的AI

**VS代码(副本)和游标——零配置。** 扩展注册其MCP
服务器自动。只需安装Debugssy并开始聊天。无JSON编辑
需要。

> 如果你有旧的手册 `"debugssy"` 在设置中输入,将其删除到
> 避免重复。

**其他MCP客户端** (克劳德桌面、克劳德代码、OpenCode等)——添加这个
到客户端的配置文件:```json
{
"mcpServers": {
"debugssy": { "url": "http://localhost:3000/mcp" }
}
}

配置文件位置:

  • 克劳德桌面:
    ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)或
    %APPDATA%\Claude\claude_desktop_config.json (Windows)
  • 克劳德代码/开放代码/其他: 查看客户的文档——URL为
    总是 http://localhost:3000/mcp

3.调试一些东西

  1. 在VS Code中启动调试会话(F5)
  2. 问你的AI: “设置一个用户身份验证失败的断点,并向我显示
    请求对象中有什么“
  3. 看着它工作

类型 / 在聊天中查看指导工作流程,如 /debug-crash 或
/trace-variable.


两种模式

辅助(默认): 您可以控制执行(F5,步骤,继续)。AI设置
断点并检查状态。有利于学习和动手。

全自动化: AI控制一切——开始会话,继续
过去的断点,工作。适用于“只是找到bug”的场景。```json
{ "debugssy.automationLevel": "full" }


副驾驶用户:切换模式后重新启动VS Code(它不会刷新工具
动态)。

______________________________________________________________________

## 可用工具

您的AI通过MCP看到这些:

**检查** (始终可用): `get_debug_state`, `get_variables`,
`get_call_stack`, `evaluate_expression`, `get_console_output`, `get_threads`

**断点** (始终可用): `set_breakpoint`, `remove_breakpoint`,
`list_breakpoints`, `toggle_breakpoint`, `remove_all_breakpoints`

`set_breakpoint` 支持条件(`user.role === 'admin'`),点击次数
(`> 10`),并记录消息(日志点)。

**执行控制** (仅限全模式): `start_debugging`, `stop_debugging`,
`continue`, `pause`, `restart`, `wait_for_breakpoint`

步骤操作(`step_over`, `step_into`, `step_out`)全部可用
模式(如果启用) `debugssy.allowStepOperations`.通常是不必要的--战略性的
断点+继续对于AI调试更快。

______________________________________________________________________

## 设置

打开VS Code设置并搜索“debugssy”:

|设置|默认值|它的作用|
| ------------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------- |
| `debugssy.mcp.port` | `3000` |服务器端口。如果使用3000,请更改。                                                                   |
| `debugssy.automationLevel` | `assisted` | `assisted` 或 `full` |
| `debugssy.expressionValidationLevel` | `moderate` |有多多疑 `evaluate_expression`.选项: `strict`, `moderate`, `permissive`, `disabled` |
| `debugssy.maxExpressionLength` | `100` |已求值表达式的最大字符数|
| `debugssy.waitForBreakpointTimeout` | `5000` |多长时间 `wait_for_breakpoint` 等待时间(ms)|
| `debugssy.allowStepOperations` | `false` |在完全模式下启用step_over/into/out|

为了更严格的安全性,请在MCP客户端中配置一个分配列表——请参阅
允许_用户.md.

______________________________________________________________________

## 安全

Debugssy仅在本地主机上运行。你的代码永远不会离开你的机器。

表达式验证器阻止明显的注入尝试(`eval`,
`require('fs')`, `process.exit`等),并要求确认任何事情
可疑。偏执的四个层次: `strict` (仅白名单), `moderate`
(默认情况下,阻止已知的危险模式), `permissive` (仅屏蔽恐怖内容
东西), `disabled` (你只能靠自己了)。

人工智能辅助调试的最佳实践:

1. **重新开始。** 在调试会话中使用新的AI对话以避免提示
从早期背景中注入。
1. **跳过网络搜索。** 不要在同一次对话中搜索网络——外部
内容物是及时注射的主要载体。
1. **回顾启发提示。** 当验证器询问表达式时,
在批准之前,请仔细阅读。

详细信息: 安全.md,
MCP_合作.md

______________________________________________________________________

## 故障排除

**“没有活动的调试会话”** --开始调试(`F5`)在要求AI
检查事物。调试器需要运行。

**端口3000正在使用中** --更改 `debugssy.mcp.port` 对于其他事物(3001、8080、3003),
不管怎样)。或者杀了那些占了3000块的东西:```bash
# Windows
netstat -ano | findstr :3000
taskkill /PID  /F

# Mac/Linux
lsof -ti:3000 | xargs kill -9

AI无法连接 --检查VS代码输出面板
(View → Output → Debugssy).验证服务器是否已启动
curl http://localhost:3000/health确保你的AI配置指向
http://localhost:3000/mcp.

变量为空 --必须在断点处暂停执行。如果它正在运行,
没有什么可检查的。也试试 scope: "Local" 以滤除噪声。

副驾驶看不到新工具 --重新启动VS代码。Copilot缓存工具
列表。


建筑```

┌─────────────────────────────────────────────────┐
│ VS Code Extension │
│ │
│ MCP Server (localhost:3000) │
│ ↓ │
│ ToolRouter → Security Layer → Tool Registry │
│ ↓ │
│ DAP Client ← → VS Code Debug API │
└─────────────────────────────────────────────────┘
↑
│ HTTP + MCP Protocol
↓
┌─────────────────────┐
│ AI Assistant │
│ (Cursor/Copilot/ │
│ Claude Desktop) │
└─────────────────────┘


MCP服务器使用流式HTTP(规范版本2025-06-18)。会话ID为
`crypto.randomUUID()`所有工具输入都经过Zod验证。

关键文件,如果你正在潜水:

- `src/MCPServer.ts` --服务器设置和MCP协议处理
- `src/routing/ToolRouter.ts` --工具调度
- `src/security/ExpressionValidator.ts` --偏执狂引擎
- `src/dap/Client.ts` --调试适配器协议集成

______________________________________________________________________

## 从源头构建```bash
git clone https://github.com/gmaynez/debugssy.git
cd debugssy
npm install
npm run compile    # Build
npm run package    # Creates .vsix
npm test           # Run tests

按 F5 在VS Code中启动扩展开发主机进行实时测试。


已知限制

  • 一次一个MCP客户端。 如果多个AI助手连接到同一个
    Debugssy实例,最新连接接管。
  • Copilot缓存工具。 更改后重新启动VS代码 automationLevel.
  • 没有手表表情。 使用 evaluate_expression 相反。
  • 单线程假设。 默认为线程ID 1。
  • 辅助模式对手动步骤视而不见。 如果在UI中单击“继续”,
    AI不知道。
  • 嵌套对象被截断。 责怪调试器,而不是我们。

贡献

发现bug了吗? 打开一个问题.

想贡献吗?分叉它,创建一个分支,打开一个PR。遵循现有代码
风格(TypeScript、ESLint)。添加新功能的测试。

检查
好的第一个问题
对于初学者任务。


更多文档

  • 安全.md --威胁模型、安全策略
  • 允许_用户.md --锁定您的哪些工具
    AI可以使用
  • DEBUGSSY_PROMPT.md --AI助手详细指南
  • MCP规范 --协议本身
  • 调试适配器协议
    --VS Code在幕后说什么

许可证

Apache 2.0。看 许可证.

版权所有©2025-2026吉列尔莫·加西亚·马内兹

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
debugssy (Gmaynez) 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

debugssy (Gmaynez) 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

debugssy (Gmaynez) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

debugssy (Gmaynez) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

debugssy (Gmaynez) 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

debugssy (Gmaynez) 能提供哪些能力?

资料显示约 17 个工具;能力标签包括 编程辅助、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。