Oss Nexera Debugger MCP


Nexera调试器MCP

VS Code扩展，使AI代理能够 交互式调试 应用程序——就像人类开发人员一样——通过 模型上下文协议（MCP）.与合作 VS Code, 反重力，以及任何兼容MCP的AI客户端。

而不是依赖 console.log 事实上，使用Nexera Debugger MCP的代理可以设置断点，在故障的确切点暂停执行，逐行遍历代码，检查实时运行时状态的变量，在上下文中评估表达式，并导航调用堆栈。这就是两者之间的区别 *猜测* 日志中出现了什么问题 *看见* 它实时发生。

为什么要对AI进行交互式调试？

Nexera调试器MCP将AI代理从 *猜测bug的代码生成器* 进入一个 观察、假设和验证的推理调试器 --同样的反馈循环使经验丰富的开发人员高效工作。

快来看看

https://github.com/user-attachments/assets/bc632185-6668-43df-be30-215fac79380a

我们为什么建造这个

我们想回答一个大问题： 当AI代理可以与正在运行的代码交互时，它们是如何推理的？

该项目为代理提供了与人类开发人员使用的调试工具相同的工具——断点、步进、变量检查、实时评估——并允许他们浏览代码库，通过观察而不是猜测来查找和修复错误。

我们建造这个是因为：

• 🔬 我们正在探索 代理如何与SDLC交互——不仅仅是编写代码，还要在运行时理解它
• 🤝 我们需要社区意见 --欢迎提供意见、想法和反馈
• 🎯 它真的很有用 --看着人工智能代理遍历代码，推理状态，并专注于bug，这有点神奇

如果你能找到让它变得更好的方法——欢迎公关。 🚀

⚠️ 安全注意事项

在启用此扩展之前，请了解风险：

任意代码执行

此MCP中的一些工具允许代理 执行任意代码 在您正在运行的应用程序的上下文中。这些被归类为 第3层 工具：

默认情况下， 所有层都已启用。如果要将代理限制为只读检查和标准调试控件，请在VS代码设置中禁用第3层：

{
  // Only allow read-only (tier1) and standard debugging (tier2) tools
  "debugAutomation.security.allowedTiers": ["tier1", "tier2"]
}

看 MCP_TOOLS_REFERNCE.md 对于完整的层级细分。

敏感数据泄露

当代理检查变量、计算表达式或读取内存时，它可能会遇到 敏感信息 -应用程序运行时状态中存在的API密钥、令牌、密码、PII或其他机密。请注意：

• 返回的变量值 inspect_variables 和 eval_expression 被发送回代理（并可能被记录或转发给链中的其他工具）
• 扩展 不过滤或编辑 敏感值——它返回调试器看到的内容
• 控制台输出由捕获 observe_console 也可能包含敏感数据

推荐：在具有测试数据的开发环境中使用此工具。调试处理生产机密或真实用户数据的应用程序时要小心。

代币使用和成本

\[！小心\] 活动调试会话是令牌密集型的。 在开始扩展调试会话之前，请注意对AI使用配额和成本的影响。

交互式调试是固有的 健谈的每一步、断点命中、变量检查、作用域枚举和表达式求值都是一个单独的MCP工具调用——每一步都是一次往返，将结构化数据发送回代理并消耗输入和输出令牌。一个调试会话可以轻松生成10行代码、检查3个作用域并计算几个表达式 数十次工具调用 具有大量的响应有效载荷。

这意味着：

• VS代码副本/GitHub副本：调试会话将比正常的代码生成或聊天交互更快地消耗您的高级请求分配。如果你在使用限制计划中，一次彻底的调试会话可能会占用你配额中有意义的一部分。
• 反重力：模型选择很重要——使用前沿模型（如Claude Opus、GPT-5.2、Gemini 3.0 Pro）进行调试，每次会话的成本将比使用较小的模型高得多。考虑这个bug是否需要深入的推理，或者一个更轻的模型是否就足够了。
• 任何具有计量API访问权限的MCP客户端：同样适用。每次工具调用响应——尤其是 inspect_variables 对于大型物体， browser_dom_snapshot，或 browser_screenshot --可以返回大量有效载荷，从而增加令牌计数。

管理使用情况的提示：

• 🎯 成为目标 --向代理明确描述错误以及要调查的文件/函数，而不是要求它“探索整个应用程序”
• ⏱️ 设定界限 --请代理在发现第一个错误后停止，而不是彻底测试所有内容
• 📉 使用较轻的型号进行分流 --为需要深入推理的复杂bug保存边界模型
• 🔍 使用 console.log 对于广度，MCP调试用于深度 --如果您不确定错误在哪里，请先用日志缩小范围，然后将调试器附加到特定区域

MCP刀具表面--34刀具

扩展暴露 34个MCP工具 分为8类。所有工具都适用于DAP（VS代码调试器）和CDP（Chrome DevTools协议）模式。

会话管理（4个工具）

执行控制（7个工具）

检查（6个工具）

断点（5个工具）

评估（3个工具）

浏览器和CDP（7个工具）

可观察性（2个工具）

有关完整的参数文档，请参阅 MCP工具参考.

架构概述

扩展分为重点模块：

• VS代码扩展入口点 (src/extension.ts)--连接命令、配置和UI界面。
• MCP服务器+网桥 (src/mcpServer.ts, src/websocketServer.ts, src/bridge/)--处理MCP请求处理和WebSocket传输。
• 调试会话编排 (src/debugManager.ts, src/models/)--管理会话生命周期和状态。
• 工具表面 (src/tools/consolidated/)--34个MCP工具，用于会话控制、断点、评估、检查和浏览器交互。
• CDP集成 (src/cdp/)--用于浏览器调试的Chrome DevTools协议工具。
• 安全 (src/security/)--授权层和验证规则。
• UI视图 (src/views/)--VS Code中的MCP控制面板。

入门指南

先决条件

• Node.js（建议使用当前的LTS）
• VS Code 1.96+或VS Code内部人士

安装依赖项

npm install

构建扩展

npm run compile

打包VSIX

npx vsce package --no-dependencies

安装VSIX

code --install-extension nexera-debugger-mcp-*.vsix

MCP服务器和配置

MCP服务器自动启动（可通过设置进行配置）。您还可以通过以下方式进行控制 调试自动化 VS代码活动栏中的视图。

VS代码MCP配置

使用以下命令之一：

• 调试自动化：配置mcp.json （将文件写入您选择的位置）。
• 调试自动化：复制MCP配置（VS代码） （将JSON片段复制到剪贴板）。

典型的VS代码配置如下：

{
  "servers": {
    "nexera-debugger": {
      "command": "node",
      "args": ["
/nexera-mcp-launcher.js"]
    }
  }
}

反重力MCP配置

使用 调试自动化：复制MCP配置（反重力） 复制反重力特定配置。反重力使用 mcpServers 密钥而不是 servers:

{
  "mcpServers": {
    "nexera-debugger": {
      "command": "node",
      "args": ["
/nexera-mcp-launcher.js"]
    }
  }
}

测试项目和快速验证

一个小型的Node.js测试项目包含在 test-app-to-debug/.

1. 在VS Code中打开此存储库。
2. 开始调试 test-app-to-debug/test.js 使用Node.js调试器。
3. 确认MCP服务器正在运行 调试自动化 面板。
4. 从您的MCP客户端致电 session_list 以验证会话是否可见。
5. 使用设置断点 breakpoint_add 和使用 exec_continue 击中它。
6. 检查变量 inspect_stack_trace → inspect_scopes → inspect_variables.

许可证

MIT许可证。看 许可证.