# @debugbundle/mcp 中文文档

规范地址：https://npmcn.com/package/%40debugbundle/mcp/

版本：1\.23\.0
npm 元数据更新时间：2026-11-11T01:38:18.408Z
中文译文更新时间：2026-11-11T19:50:19.617Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40debugbundle/mcp
原文对照：https://npmcn.com/package/%40debugbundle/mcp/?lang=original
项目主页：https://debugbundle.com/docs/mcp
源码仓库：https://github.com/debugbundle/debugbundle

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.3 MB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22 \<27
- 运行依赖：1 个
- 首次发布：2026-05-06T10:39:24.721Z
- 最新版本发布：2026-11-11T01:38:18.056Z
- 近 30 天下载量：3972（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：55（近 12 个月 55 个）

## 中文简介

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

## 安装

```sh
npm install @debugbundle/mcp
```

也可以使用：`pnpm add @debugbundle/mcp`、`yarn add @debugbundle/mcp`、`bun add @debugbundle/mcp`

## README

# @ 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相同的权限和政策; 主机只读和限制目录保持不变。 见 [工具参考](https://debugbundle.com/docs/mcp/tools/)。 。 。 .

用 npm 直接运行 stdio 服务器 :

```bash
npx @debugbundle/mcp
```

或在全球安装:

```bash
npm install -g @debugbundle/mcp
debugbundle-mcp
```

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

## MCP 客户端配置

```json
{
  "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和工作流程技能 |
| 代码直接 MCP | `codex mcp add debugbundle -- npx -y @debugbundle/mcp@1.23.0 --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服务器. 见 [代码开发软件包](https://npmcn.com/package/plugins/debugbundle-codex/README.md) 财务报告和审定财务报表 [代码设置指南](https://debugbundle.com/docs/mcp/codex/) 用于存储器市场、直接配置、认证、核查和去除。 在 GitHub 安装工程之前, 寄存器插件必须发布在默认分支上; 本地取出安装可供候选人验证 .

## 克劳德桌面

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

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

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

## 克劳德代码插件

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

```text
/plugin marketplace add debugbundle/debugbundle
/plugin install debugbundle@debugbundle
```

插件软件包位于 `apps/mcp/claude-code/debugbundle` 并捆绑克洛德代码技能。 见 [Claude 代码设置指南](https://debugbundle.com/docs/mcp/claude-code/) 用于插件被绑定的 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` 在本地唯一的诊断、本地捆绑分析或生成项目技能工作流程之前. |

## 链接

-   文档 : [https://debugbundle.com/docs/mcp 页面存档备份,存于互联网档案馆](https://debugbundle.com/docs/mcp)
-   代理工作流程 : [https://debugbundle.com/docs/代理工作流程](https://debugbundle.com/docs/agent-workflows)
-   LLM 索引 : [https://debugbundle.com/llms.txt (中文(简体) )](https://debugbundle.com/llms.txt)
-   MCP 工具计划 : [https://debugbundle.com/schemas/mcp-tools.json (中文(简体) )](https://debugbundle.com/schemas/mcp-tools.json)
-   OpenAI 插件候选人 : [https://debugbundle.com/docs/mcp/openai-plugin 页面存档备份,存于互联网档案馆](https://debugbundle.com/docs/mcp/openai-plugin)
-   官方的MCP 登记册元数据: [https://github.com/debugbundle/debugbundle/blob/main/apps/mcp/server.json 互联网档案馆的存檔,存档日期2013-12-22](https://github.com/debugbundle/debugbundle/blob/main/apps/mcp/server.json)

## 警卫 还有信任

-   官方的MCP 登记名称: `com.debugbundle/mcp`。 。 。 .
-   官方 npm 软件包 : `@debugbundle/mcp`。 。 。 .
-   源寄存器 : [https://github.com/debugbundle/debugbundle/tree/main/apps/mcp 页面存档备份,存于互联网档案馆](https://github.com/debugbundle/debugbundle/tree/main/apps/mcp)
-   许可证: Apache -2.0.
-   服务器使用stdio transport和本地流程证书. 它不包括隐藏主机管理认证 .
-   公共例子必须只使用占位符;从不粘贴真正的成员标志,项目标志,webhook秘密,或客户配置入市场上市.

## 许可证

阿帕奇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和诊断不公开. 新支票仍为私人支票。 主机只读 和有限代理人简介不披露出版工具。 见 [状态页面指南](https://debugbundle.com/docs/availability-checks/)。 。 。 .

## 常见问题

### @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 和提交记录判断。