@debugbundle/mcp

中文文档
1.23.0发布于 2026/11/11Apache-2.0ES Module构建来源已验证近 30 天下载 3972

MCP 用于运行时间错误报告、事件反应、健康检查、调试捆绑和产品分析的服务器

中文使用文档
文档目录20 节
  1. 1.19.4 当地文物安全
  2. 1.19.4 云缓存安全
  3. 1.19.4 安装指导
  4. 1.19.1 当地关联安全
  5. 项目/服务合并 1.19.1
  6. 更正更新 1.18.3
  7. 安装
  8. MCP 客户端配置
  9. 安装矩阵
  10. 本地认证配置
  11. 代码
  12. 克劳德桌面
  13. 克劳德代码插件
  14. 认证
  15. 探员能做什么
  16. 解决问题
  17. 链接
  18. 警卫 还有信任
  19. 许可证
  20. 公共状况页面

@ debugbundle/ mcp (英语)

1.19.4 当地文物安全

保存的捆绑和复制路径必须保存在他们的克恩克当地文物中 目录. 不安全元数据返回 invalid_local_artifact_path 没有阅读, 重写或删除无关的文件 。 链接文件/ 指令失败 . 当地正常商店及其现有规模津贴得到保留;当地州 和处理写作 使用小心的原子替换。 这将取代先前的客户端 .

1.19.4 云缓存安全

在云请求和缓存写入前, 升级为 1. 19.4 , 用于事件ID验证 . 不安全的身份证返回 invalid_incident_id;UUID和现有的不透明ID仍然支持. Cloud 缓存读取、写取和保留 拒绝符号链接; 写出使用注意的 原子替换。 这纠正了早期客户端的路径倒转.

1.19.4 安装指导

优先每个系统一个项目跨越服务库,重新使用现有连接,并为不同的访问或隐私政策保留单独的项目. 在第一次连接之前检查已有的项目;名称匹配不会推断系统成员.

1.19.1 当地关联安全

追踪关联只在同一个项目和环境内交叉服务. 如果旧缓存包含混合保留源事件,则读取并递增 处理失败 local_incident_scope_mismatch保护当地商店, 并使用 debugbundle process --preset <minimal|balanced|investigative> 与预期 抓取预设。 重建当地事件/艺术状态 不更改云记录或保留的事件文件.

项目/服务合并 1.19.1

添加逻辑服务上下文并检查项目组合预览、应用、状态, 核查、恢复和取消。 现有身份、全权证书和 受限范围仍相容。 合并应用程序需要合格的兼容性 核心 1.21.0 运行时间,默认情况下仍然禁用.

已连接 doctor 诊断检查API的健康,并用限制在 cloud_project_id。在提出任何请求之前,缺失或空白连接的项目范围失败。 事件内容被丢弃,不列入报告. 本地独有的诊断不求云.

连接工作空间事件列表使用已保存的连接 cloud_project_id 除非 projectId 明确提供。 这也适用于: source: "cloud" 和每出云页. 一个无法连接的项目失败 invalid_local_connection_config 清单请求之前 工程或修复连接。 当地证据和全账户未连接 成员保留其现有行为.

MCP服务器用于运行时间错误报告,崩溃报告,事件应对,端点健康检查,调试捆绑,以及产品分析. DebugBundle让代理商通过与API和CLI相同的管理表面来检查客户端事件,决定性捆绑,产品使用证据,复制,探测,警报,网络呼号,项目,以及设置状态. 它是生产调试基础设施,而不是一个通用的基础设施监测或可观察性平台.

更正更新 1.18.3

连通事件列表现在保留了它们在所有页面上选定的云项目, 包括明确的云读取。 列表前无效的连接范围失败 请求。 工具名称、计划、成员认证和当地证据选择 保持兼容性。 协调的 OpenClaw 插件修复本地的无害环境管理加载和 增加安装的 -- -- 主机/运行时间检查;市场安全接收将分开.

安装

普通认证的MCP包括账户/项目通知优惠, 频道特定暂停/重播, 以及每日与本地时间和 IANA 的电子邮件调度 时区。 这些工具使用与API和CLI相同的权限和政策; 主机只读和限制目录保持不变。 见 工具参考。 。 。 .

用 npm 直接运行 stdio 服务器 :

npx @debugbundle/mcp

或在全球安装:

npm install -g @debugbundle/mcp
debugbundle-mcp

所支持的Node.js版本:22.x至 26.x.

MCP 客户端配置

{
  "mcpServers": {
    "debugbundle": {
      "command": "npx",
      "args": ["@debugbundle/mcp"]
    }
  }
}

使用 npx -y @debugbundle/mcp 在需要非交互软件包执行的客户端中.

安装矩阵

环境建议路径页:1
一般本地 MCP 客户端npx @debugbundle/mcp运输
Claude 桌面本地 MCP本地 MCP 服务器配置使用本地机器认证/配置
Claude 代码插件/plugin marketplace add debugbundle/debugbundle安装捆绑的 MCP 配置和调试Bundle 技能
代码开发器插件codex plugin add debugbundle-codex@debugbundle存储库市场; 本地MCP和工作流程技能
代码直接 MCPcodex mcp add debugbundle -- npx -y @debugbundle/[email protected] --local-auth同一主机上的应用程序、 CLI 和 IDE
光标MCP 配置为 npx @debugbundle/mcp运输
VS 代码 / GitHub MCP 书记官处com.debugbundle/mcp正式登记元数据
OpenClaw / ClawHub 密码调试Bundle 技能加 MCP 配置使用已公布的技能进行工作流程指导
首席调查员/无头人员DEBUGBUNDLE_MEMBER_TOKEN从不使用工程符号
自行托管调试程序DEBUGBUNDLE_API_URL 加成员认证将服务器指向您的 API 基础 URL

这个软件包是支持的公用本地 stdio 路径. 单独的 OpenAI 插件 使用 OAuth 保护的只读远程端点 https://mcp.debugbundle.com/mcp其审查/出版过程是独立的 不更改此软件包的目录或认证.

本地认证配置

MCP 1.9.0 添加 npx @debugbundle/mcp --local-auth选项配置文件删除 bearerToken 从工具 schemas,拒绝每个调用证书和未知字段,并且只使用服务器的启动 CLI/环境成员认证. 需要成员符号失败的托管工具 mcp_tool_error:auth_state_missing aPI 请求前, 当认证不存在; 运行 debugbundle login 在主机上或配置服务器环境并重新启动连接。 仅供本地检索,但无标识。 默认引用保留了遗留的图案和明确的每个工具符号优先.

代码

Codex可以在主机OpenAI插件之外独立使用现有的stdio服务器. 见 代码开发软件包 财务报告和审定财务报表 代码设置指南 用于存储器市场、直接配置、认证、核查和去除。 在 GitHub 安装工程之前, 寄存器插件必须发布在默认分支上; 本地取出安装可供候选人验证 .

克劳德桌面

在克洛德桌面中,打开设置 > 开发者,编辑本地 MCP 配置,并添加:

{
  "mcpServers": {
    "debugbundle": {
      "command": "npx",
      "args": ["-y", "@debugbundle/mcp"]
    }
  }
}

运行 debugbundle login 首先重用本地 CLI 认证状态,或添加 DEBUGBUNDLE_MEMBER_TOKEN 到服务器环境,供管理下/无头使用。 设定 DEBUGBUNDLE_API_URL 仅针对自控或非默认 API 主机.

克劳德代码插件

Claude Code 用户可以从此寄存器中添加 DebugBundle 的第一当事方市场:

/plugin marketplace add debugbundle/debugbundle
/plugin install debugbundle@debugbundle

插件软件包位于 apps/mcp/claude-code/debugbundle 并捆绑克洛德代码技能。 见 Claude 代码设置指南 用于插件被绑定的 MCP 版本,直接 MCP 配置,认证,验证,更新和去除. 它的结构也是为了Claude社区市场审查;不要将其描述为载于 claude-community 直到Anthropic接受并出版.

认证

模式使用页:1
CLI 认证状态本地开发机重用 ~/.debugbundle/auth.json 当可用时.
DEBUGBUNDLE_MEMBER_TOKEN无头客户或市场管理的客户成员标志用于CLI/API/MCP读取和管理操作.
每个工具 bearerToken明确的高级自动化只覆盖此调用默认 .
项目符号只摄入 SDK不使用工程令牌进行MCP检索或管理.

探员能做什么

  • 阅读公共项目购置/激活定义和综合报告 list_analytics_flows 财务报告和审定财务报表 get_analytics_flow_report;所有者/管理人员可以管理它们 与 save_analytics_flow 财务报告和审定财务报表 archive_analytics_flow。这些开发工具的使用 与API、CLI和Web相同的项目授权和流动服务。 分开 主机OpenAI目录不变 .

  • 列出活动事件并获取全部事件背景.

  • 获取决定性调试包和复制文物.

  • 以 get_analytics_filter_options * 授权项目、期限、颗粒性和服务/环境。 被捆绑的相机曝光 values 财务报告和审定财务报表 truncated,带有批准的自定义密钥,没有生成配额。 空/ 无法获取的选择不能被发明的默认替换 。 此工具仅为普通的MCP;受限代理/OpenAI目录保持不变.

  • 查询总体使用情况、路线、设备/浏览器/操作系统/语言段、裁判员、动作、漏斗和旅行模式,而不等待分析文物通过 get_usage_summary, (中文(简体) ), get_route_metrics, (中文(简体) ), get_device_breakdown, (中文(简体) ), get_action_metrics, (中文(简体) ), get_funnel_analysis,相关读取.

  • 检查保留了经编辑的出行样本,分析机会,并生成了Analytics Bundles;当仅汇总度量不足时,请求提供有限度的分析文物.

  • 在提议隐私、保留、同意、获取或核准定制修改之前,先读取分析设置;仅以明确所有人/管理人的意图加以更新.

  • 列表中保存了分析漏斗,并随着所有者/管理员的访问,通过创建、更新或归档可重复使用的漏斗定义 list_saved_analytics_funnels, (中文(简体) ), create_saved_analytics_funnel, (中文(简体) ), update_saved_analytics_funnel,以及 archive_saved_analytics_funnel。 。 。 .

  • 被检查者主持健康检查,探测,警报,网络呼喊,项目,成员,计费,抓取政策,以及GitHub自动化状态.

  • 通过诸如下列工具运行本地和主机验证 verify_local, (中文(简体) ), verify_cloud, (中文(简体) ), doctor, (中文(简体) ), smoke,以及 analyze。 。 。 .

verify_app_event 提供真实的 SDK 驱动应用程序证明,匹配 CLI verify cloud --expect-app-event。通过 projectId 其中至少一个 service, (中文(简体) ), traceId,或 requestId· ; environment, (中文(简体) ), maxAgeMinutes,以及 authFilePath 为: 选项。 它读取了现有的事件/捆绑,从不发送合成事件. 现有 verify_cloud 计划和说明保持不变。 新工具 可通过普通和当地的平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平; 主机只读和限制代理目录保持不变.

  • 核实后解决或重开事件.

对于分析问题,首先使用直接的聚合工具,并且只有在边框分析需要耐用文物时才能生成AnalyticsBundle. 产品不会每次访问产生一捆.

解决问题

症状检查
节点.js发射失败使用节点.js 22.x到 26.x. 配置使用所支持的客户端 node 或者说 npx 运行时间.
缺少本地认证运行 debugbundle login,或设置 DEBUGBUNDLE_MEMBER_TOKEN 无头管理客户.
无效的符号使用一个 dbundle_mem_ 成员标志。 项目令牌是SDK只摄取的证书.
错误的 API 主机离开 DEBUGBUNDLE_API_URL 未为 DebugBundle Cloud 设定;仅为自控或非默认 API 主机设定 .
本地重播未初始化运行 debugbundle setup 在本地唯一的诊断、本地捆绑分析或生成项目技能工作流程之前.

警卫 还有信任

许可证

阿帕奇2.0 (英语).

disconnect_github_installation 将现有的全组织断开 路线。 它需要活动组织的所有者并删除寄存器任务 所有项目,包括降级后的清理。 它不会解开 在GitHub上应用. 安装/重新连接使用仪表盘浏览器流程保留所签名 州饼干。 普通/本地目录现在包含134个工具; 托管的23个工具和有限的5个工具配置保持不变.

test_webhook_event 接受所有八起支持的 webhook 事件 范围测试服务。 遗产 test_webhook 计划仍然是只核查的. 两个队列一个签名的合成信封,没有产生真正的事件或捆绑.

公共状况页面

get_public_status_page, (中文(简体) ), list_public_status_page_options, (中文(简体) ), save_public_status_page 财务报告和审定财务报表 preview_public_status_page 管理所有者控制 通过与健康项目相同的API出版。 读取选项, 选择检查 明确并保存 {title, enabled, projects:[{project_id, check_ids}]}保存 enabled: false 在不更改 URL 的情况下取消 publishes 。 只发布于所有者 指示:选定项目/检查名称和总体提供情况公开; URL和诊断不公开. 新支票仍为私人支票。 主机只读 和有限代理人简介不披露出版工具。 见 状态页面指南。 。 。 .

版本与发布记录

@debugbundle/mcp 共发布 55 个版本,首次发布于 2026/05/06;过去 12 个月发布了 55 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.23.0latest2026/11/11今天
1.22.02026/11/111 天前
1.21.02026/11/092 天前
1.20.02026/11/056 天前
1.19.42026/11/056 天前
1.19.32026/11/056 天前

其他发布通道:next → 0.1.0-next.1。

关于 @debugbundle/mcp 的常见问题

@debugbundle/mcp 是什么?

MCP 用于运行时间错误报告、事件反应、健康检查、调试捆绑和产品分析的服务器

如何安装 @debugbundle/mcp?

在项目目录运行 npm install @debugbundle/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 debugbundle-mcp,可以用 npx debugbundle-mcp 直接运行。

@debugbundle/mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/debugbundle__mcp 是否存在。

@debugbundle/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@debugbundle/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22 <27。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@debugbundle/mcp 可以商用吗?

@debugbundle/mcp 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@debugbundle/mcp 的下载量有多少?

根据 npm 官方下载统计,@debugbundle/mcp 在 2026/10/12 – 2026/11/10 这 30 天内被下载 3,972 次,日均约 132 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@debugbundle/mcp 还在维护吗?

最新版本 1.23.0 发布于 2026/11/11(今天);至今共发布 55 个版本,其中过去 12 个月发布了 55 个;首次发布于 2026/05/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。