# @debugmcp/mcp-debugger 中文文档

规范地址：https://npmcn.com/package/%40debugmcp/mcp-debugger/

版本：0\.26\.0
npm 元数据更新时间：2026-10-31T03:14:34.976Z
中文译文更新时间：2026-11-11T18:51:13.247Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：9.5 MB，139 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.0\.0
- 运行依赖：0 个
- 首次发布：2025-07-15T06:42:11.327Z
- 最新版本发布：2026-10-31T03:14:34.606Z
- 近 30 天下载量：11267（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 16 个）

## 中文简介

LLMs 的分步调试 MCP 服务器

## 安装

```sh
npm install @debugmcp/mcp-debugger
```

也可以使用：`pnpm add @debugmcp/mcp-debugger`、`yarn add @debugmcp/mcp-debugger`、`bun add @debugmcp/mcp-debugger`

## README

# @ debugmcp/ mcp- 调试器

步入调试 LLMS 的 MCP 服务器。 —— **29个工具** 覆盖断点(行,语句-指定,函数,日志点),脚步,堆放/可变检查,表达式评价,缓冲程序输出,启动/attach/重启生命周期,以及仅读取的活会话 IDE 镜像.

## 安装

您可以不通过 npx 安装使用此软件包 :

```bash
npx @debugmcp/mcp-debugger stdio
```

或在全球安装:

```bash
npm install -g @debugmcp/mcp-debugger
```

### 代理技能和 Pi 软件包

包裹运送 [`mcp-debugger` 代理技能](https://github.com/debugmcp/mcp-debugger/tree/main/skills/debugging) 时间 `skills/debugging/` (当调试时,会话黄金路径,根-原因纪律,每个语言) 页:1 也是个 [毕](https://github.com/earendil-works/pi) 编码代理软件包 : `pi install npm:@debugmcp/mcp-debugger` 安装技能和扩展 (单位:千美元)`extensions/mcp-debugger.js`以 pi 内置的 MCP 支持注册服务器( pi 0. 99 或 之后,运行安装在旁边的CLI.

## 使用量

### STIO 模式( 默认)

```bash
mcp-debugger stdio
```

### SSE 模式

> **折旧:** SSE运输被贬值,将在未来发行被移除. 使用 `mcp-debugger http --port 3001` 换句话说.

```bash
mcp-debugger sse --port 3001
```

### HTTP 模式( 建议)

```bash
mcp-debugger http --port 3001
```

### 诊断你的设置

```bash
mcp-debugger doctor                # report every adapter (informational, always exits 0)
mcp-debugger doctor python go      # gate the exit code on the named languages
mcp-debugger doctor --json
```

`doctor` 探测每个适配器的运行时间,在一次通过中调试后端,然后打印 a 每种语言的判决,加上任何需要注意的补救。 你先来 当一个语言被报告无法使用时, 或者在程序启动前发射失败时 启动。 语言参数退出 `1` 当任何要求的语言是 `broken`, (中文(简体) ), `missing`, (中文(简体) ), `disabled`,或未知(和 `2` 当医生失败的时候 它总是离开 `0`。 。 。 . `--timeout <ms>` 盖住每种语言的探测器(默认为1000).

见 [诊断指南](https://github.com/debugmcp/mcp-debugger/blob/main/docs/diagnostics.md) 用于每种语言的先决条件和失败签名.

## 电池- 包含的适配器

所有语言适配器被捆绑入CLI包. 不需要单独安装。 包括下列适配器:

-   **蟒** (单位:千美元)`@debugmcp/adapter-python`) - Python 通过调试调试
-   **鲁比** (单位:千美元)`@debugmcp/adapter-ruby`\- Ruby通过rdbg调试
-   **Java 脚本** (单位:千美元)`@debugmcp/adapter-javascript`) - JavaScript/Node.js 通过js-debug调试
-   **锈** (单位:千美元)`@debugmcp/adapter-rust`) - 通过代码LDB进行 Rust调试
-   **走开** (单位:千美元)`@debugmcp/adapter-go`\-通过Delve调试
-   **爪哇语** (单位:千美元)`@debugmcp/adapter-java`\- Java通过JDI桥调试
-   **. NET 网络** (单位:千美元)`@debugmcp/adapter-dotnet`) -.NET通过净分数bg调试
-   **页:1** (单位:千美元)`@debugmcp/adapter-cpp`) - C/C++通过代码LDB调试
-   **科波尔** (单位:千美元)`@debugmcp/adapter-cobol`\- COBOL通过GnuCOBOL + CodeLLDB来调试(一个 DAP shim 添加了 COBOL 形状的瞄准镜和值)
-   **达特/弗卢特** (单位:千美元)`@debugmcp/adapter-dart`\- Dart和Flutter通过SDK自己的调试适配器调试(`dart debug_adapter`, (中文(简体) ), `flutter debug-adapter`在TCP到Stdio桥后面
-   **雾** (单位:千美元)`@debugmcp/adapter-mock`\- 用于测试的模拟适配器

**系统要求:** 节点.js 22+需要运行 mcp-debugger. 启动程序还需要该语言在机器上的工具链:

-   **蟒**: Python 3.7+ 与 : `debugpy` (单位:千美元)`pip install debugpy`(中文(简体) )
-   **鲁比**: 鲁比与 `debug` 宝石`rdbg`(中文(简体) )
-   **Java 脚本/ Type 脚本**: 没有额外的 — js- debug 被捆绑
-   **锈**: Rust工具链(rustc/cargo;Windows上的GNU工具链). 代号LLDB本身是销售商——不需要系统LLDB
-   **走开**: go + Delve (中文(简体) )`go install github.com/go-delve/delve/cmd/dlv@latest`(中文(简体) )
-   **爪哇语**: JDK 21+(将目标与 `javac -g`(中文(简体) )
-   **. NET 网络**: netcoredbg + 一个相容的.NET运行时间(便携式 PDB)
-   **页:1**: 无用于预建的二进制(CodeLLDB sparnered); 仅用于孤源文件启动的编译器(g++/clang++)
-   **科波尔**: GnuCOBOL 3.1.2+ (中文(简体) )`cobc`数字 : `apt install gnucobol3`, (中文(简体) ), `brew install gnucobol`, MSYS2 软件 `mingw-w64-ucrt-x86_64-gnucobol`用于源发射和COBOL形状变量;CodelDB销售商
-   **达特/弗卢特**: 达特SDK(`dart` 在路径上,或 `DART_SDK`或小蝶( )`flutter` 在路径上,或 `FLUTTER_ROOT`),将达特捆绑;调试适配器船与SDK,没有什么是卖出. 蝶花跑者需要 `flutter --version` 一旦运行, 工具缓存将构建

> **代码LDB 平台注释 :** 代码LDB通过每个平台的可选依赖关系调试引擎船(`@debugmcp/codelldb-<platform>`) —— npm完全安装了匹配您 os/ cpu的一款,因此Rust, C/C++和COBOL在Windows, macOS,和Linux上调试工作. 安装方式 `--omit=optional` 跳过; 点 `CODELLDB_PATH` 以美元计 [代码LDB](https://github.com/vadimcn/codelldb/releases) 二进制代替,或者使用多克图像.

**无工具链附加 :** 仅限 **蟒** (单位:千美元)`debugpy --listen`和 **鲁比** (单位:千美元)`rdbg --open`页:1 _直接连接_ ——调试引擎已经在目标内部运行,因此调试机主机不需要Python或Ruby. JavaScript,Java,.NET,C/C++,COBOL和Dart/Flutter 产下一个局部适配器作为附加(`modes.attach: 'spawn'`),因此在调试器主机上需要他们的工具链——例如Java JDI桥在主机JDK上局部运行,并在JDWP上连接出,而达特SDK的适配器则连接出目标VM服务URI. `list_supported_languages` 按模式提供报告并说明理由.

### 有用的环境变量

| 变量 | 效果 |
| --- | --- |
| `DEBUG_MCP_NO_REDACT=1` | 在变量/评价/产出结果中禁用默认的秘密编辑 |
| `DEBUG_MCP_VARIABLE_ACCESS=explicit` | 最小优先模式 : `get_variables` 需要明确 `names: [...]` |
| `DEBUG_MCP_BP_ADDRESSING=line|assert|content` | 断点地址模式( 默认) `content`:声明主播+内容断言) |
| `CODELLDB_PATH` | 当平台软件包不可用时, 代码LDB 二进制路径( 见上文注) |
| `CPP_MSVC_BEHAVIOR=warn|error|continue` | 当一个 C/C++ 目标看起来是 MSVC (部分 PDB 忠诚度) 时怎么办 |
| `COBC_PATH` | Pin the GnuCOBOL 编译器 (`cobc`当它不在路径或已知安装目录中时 |
| `DART_SDK` | 达特 SDK 根(或它的根) `bin/dart`当 `dart` 不在路径上; `DART_PATH` 是别名 |
| `FLUTTER_ROOT` | 平缓 SDK 根当 `flutter` 不在路径上——当找不到独立的SDK时,使用其捆绑的达特; `FLUTTER_PATH` 是别名 |
| `MCP_HTTP_STALE_SESSION_MS` | HTTP 模式: 在此空闲时间( 默认 30 分) 之后收获从未打开 SSE 流的崩溃被忽略的 MCP 会话 |
| `MCP_HTTP_STREAM_LOST_SESSION_MS` | HTTP 模式: 收获一个会话, 其 SSE 流下降, 在此空闲时间( 默认 2分) 后再也没有返回 —— 释放一个已死客户端的暂停附加目标 |
| `MCP_HTTP_ALLOWED_HOSTS` | HTTP 和 (已过期) SSE 模式: 逗号分隔 `Host` (和浏览器) `Origin`)除此之外,还要接受主机名 `localhost`, (中文(简体) ), `127.0.0.1`, (中文(简体) ), `[::1]` – 仅在另一个访问控制前端服务器;与重复相同 `--allowed-host` |
| `MCP_HTTP_BIND` | HTTP 和 (过期) SSE 模式: 要监听的 IP 地址( 默认) `127.0.0.1`,仅回转);与 `--bind`。多克图像集 `0.0.0.0` 所以一个出版的端口作品。 拒绝启动空值 |

### 检查 Rust 二进制兼容性

```bash
mcp-debugger check-rust-binary <path-to-binary>
mcp-debugger check-rust-binary --json <path-to-binary>
```

分析一个 Rust 可执行文件,以确定它是使用 GNU 或 MSVC 工具链构建的,并报告 CodeLLDB 调试兼容性 。 使用 `--json` 用于机器可读输出.

## 选项

### 服务器选项( E)`stdio`, (中文(简体) ), `sse`, (中文(简体) ), `http`(中文(简体) )

-   `-l, --log-level <level>` - 设置日志级别(错误、警告、信息、调试;默认:信息)
-   `--log-file <path>` - 记录文件而不是控制台

### SSE 和 HTTP 选项

-   `-p, --port <number>` - SSE 或 HTTP 模式的端口( 默认: 3001)
-   `--bind <address>` - 要监听的IP地址( 默认 ): `127.0.0.1`,仅回放;或 `MCP_HTTP_BIND`) (中文(简体) ). `0.0.0.0` 收听每个接口,并且可以从其他机器中达到——用配对 `--allowed-host <name>` 这些客户端拨打的名称, 在服务器前用另一个访问控制. `localhost` 表示 `127.0.0.1`;拒绝使用主机名称和一个空值. `GET /health` 报告绑定地址和端口 `listening`。 。 。 .

### HTTP 选项

-   `--allowed-host <host>` - 额外 `Host`编号 :`Origin` 要接受的主机名( 可重复; 或) `MCP_HTTP_ALLOWED_HOSTS`,逗号分隔). 表示此服务器的另一个访问控制前方 。 无通通相. 默认 : `localhost`, (中文(简体) ), `127.0.0.1`, (中文(简体) ), `[::1]`。堕落者 `sse` 命令使用相同的选项.

### `doctor` 选项

-   `[languages...]` - 检查和打开退出代码的语言(默认:报告全部,出口0)
-   `--json` - 发一份机器可读报告
-   `--timeout <ms>` - 以毫秒计的每个语言探测超时(默认:1000)

### `check-rust-binary` 选项

-   `--json` - 发一份机器可读报告

## 文档

见 [主要仓库](https://github.com/debugmcp/mcp-debugger) 用于完整文档.

## 许可证

麻省理工学院

## 常见问题

### @debugmcp/mcp-debugger 是什么？

LLMs 的分步调试 MCP 服务器

### 如何安装 @debugmcp/mcp-debugger？

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

### @debugmcp/mcp-debugger 支持 TypeScript 吗？

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

### @debugmcp/mcp-debugger 支持 ESM 还是 CommonJS？

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

### @debugmcp/mcp-debugger 需要什么版本的 Node\.js？

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

### @debugmcp/mcp-debugger 可以商用吗？

@debugmcp/mcp-debugger 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @debugmcp/mcp-debugger 的下载量有多少？

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

### @debugmcp/mcp-debugger 还在维护吗？

最新版本 0\.26\.0 发布于 2026/10/31（11 天前）；至今共发布 25 个版本，其中过去 12 个月发布了 16 个；首次发布于 2025/07/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。