# breakpoint-mcp 中文文档

规范地址：https://npmcn.com/package/breakpoint-mcp/

版本：1\.89\.0
npm 元数据更新时间：2026-11-03T05:55:32.867Z
中文译文更新时间：2026-11-03T06:18:25.194Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/breakpoint-mcp
原文对照：https://npmcn.com/package/breakpoint-mcp/?lang=original
项目主页：https://github.com/jlivingston-Cipher/godot-breakpoint-mcp#readme
源码仓库：https://github.com/jlivingston-Cipher/godot-breakpoint-mcp

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

- 包体积（解压后）：2.4 MB，180 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：2 个
- 首次发布：2026-07-10T00:54:06.334Z
- 最新版本发布：2026-11-03T05:55:32.673Z
- 已发布版本数：51（近 12 个月 51 个）

## 中文简介

MCP服务器通过模型上下文协议将Godot暴露给AI编码助手-由Claude开发和测试-跨越四个平面（CLI，实时编辑器，LSP+DAP，运行时），使用启事式破坏性工具，在正式的MCP任务模型上进行长时间作业

## 安装

```sh
npm install breakpoint-mcp
```

也可以使用：`pnpm add breakpoint-mcp`、`yarn add breakpoint-mcp`、`bun add breakpoint-mcp`

## README

# breakpoint-mcp

MCP的 **主人** 用于 [断点MCP](https://github.com/jlivingston-Cipher/godot-breakpoint-mcp) - - - - - - 一个 [模型上下文协议](https://modelcontextprotocol.io/) 服务器，公开 戈多游戏引擎到AI编码助手跨越四个平面：无头CLI，现场直播 编辑器，Godot自己的LSP + DAP，以及运行游戏中的运行时桥。\* \* 295工具

-   6 . MCP资源\*\*，构建稳定 `@modelcontextprotocol/sdk` 1.x的API。 开发和测试 **克劳德。**;因为MCP是一个开放协议，其他客户端可以 连接也（目前未经测试-欢迎报告）。

这个包是Claude通过studio与之对话的TypeScript宿主。它需要 同伴 **戈多编辑器插件** （`breakpoint_mcp`)安装在您的项目中以达到 任何超出headless-CLI平面的内容-请参阅存储库以获取插件和完整的 体系结构。

## 安装

最快的路径-从您的Godot项目文件夹，一个命令安装并启用 编辑器插件（捆绑在这个包中）并打印你的mcp客户端配置：

```bash
npx breakpoint-mcp init
```

然后在Godot中打开项目并验证设置：

```bash
npx breakpoint-mcp doctor
```

`init` 将插件复制到 `addons/breakpoint_mcp/`，启用它 `project.godot`, 印刷品——或者，与 `--client claude-code|claude-desktop|cursor|windsurf|vscode`他写道： 客户端配置。默认情况下，它使用这个包中捆绑的插件；添加 `--from-github [ref]` 从GitHub获取插件(例如： `--from-github main`）。 `doctor` 检查Godot二进制文件、插件和四个桥接程序 (添加 `--require-live` 一旦编辑器打开； `--json` 用于机器可读的报告)。

要安装 `breakpoint-mcp` 命令全局调用，而不是通过 `npx`：

```bash
npm i -g breakpoint-mcp
```

需要 **节点≥18**． 宿主的目标是 `@modelcontextprotocol/sdk` `1.x` 行 ( `registerTool({ inputSchema, outputSchema })` +引出面)。

## 注册您的MCP客户端

克劳德是最主要的经过考验的客户 **克劳德代码:**

```bash
claude mcp add godot -- npx -y breakpoint-mcp
```

**克劳德桌面** （`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "breakpoint-mcp"],
      "env": {
        "GODOT_BIN": "/abs/path/to/Godot",
        "GODOT_PROJECT": "/abs/path/to/your/project"
      }
    }
  }
}
```

集 `GODOT_BIN` 如果 `godot` 不在你的 `PATH`． 完整的环境变量表 （bridge / LSP / DAP / runtime主机、端口和超时）和一个完整的演练 在 [库的自述](https://github.com/jlivingston-Cipher/godot-breakpoint-mcp#configuration-environment-variables) 和 [用户指南](https://github.com/jlivingston-Cipher/godot-breakpoint-mcp/blob/main/docs/USER_GUIDE.md).

使用Cursor， VS Code， Windsurf或其他MCP客户端？该命令是相同的-参见 这个 [兼容性](https://github.com/jlivingston-Cipher/godot-breakpoint-mcp#compatibility) 每个客户端的配置文件和格式。

## 插件（编辑器/运行时平面所需）

`breakpoint-mcp init` 为您安装并启用此功能-编辑器插件发布 **内部 这个包**，因此您不需要存储库来获取它。如果要手写，那就抄写 `addons/breakpoint_mcp/` 到您的项目中，并在项目设置→插件下启用它。 无论哪种方式，它都会打开此主机连接的环回服务器并自动注册 游戏运行时桥接；没有它，只有无头的cli (`godot_*`飞机工作。

## 本地第一

这座桥是一座 **当地的** 共同开发工具：所有四架飞机对话 `127.0.0.1`, 屏幕截图呈现的是真实的帧，所以主机和Godot运行在同一台机器上。一个偏远 部署看不到本地编辑器，并且仅限于headless子集。

## 安全

主机生成Godot二进制文件，可以运行GDScript和配置的本地命令，并且 将文件写入项目；破坏性工具已被确认。看到 [安全策略](https://github.com/jlivingston-Cipher/godot-breakpoint-mcp/blob/main/SECURITY.md) 了解信任模型以及如何报告漏洞。

## 许可证

MIT -见 [许可证](https://npmcn.com/package/breakpoint-mcp/LICENSE)． Godot, Claude/Anthropic，命名后端sdk是 各自所有者的商标；断点MCP是一个独立的项目 不隶属于或不被他们认可的。

## 常见问题

### breakpoint-mcp 是什么？

MCP服务器通过模型上下文协议将Godot暴露给AI编码助手-由Claude开发和测试-跨越四个平面（CLI，实时编辑器，LSP\+DAP，运行时），使用启事式破坏性工具，在正式的MCP任务模型上进行长时间作业

### 如何安装 breakpoint-mcp？

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

### breakpoint-mcp 支持 TypeScript 吗？

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

### breakpoint-mcp 支持 ESM 还是 CommonJS？

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

### breakpoint-mcp 需要什么版本的 Node\.js？

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

### breakpoint-mcp 可以商用吗？

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

### breakpoint-mcp 还在维护吗？

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