breakpoint-mcp

中文文档
1.89.0发布于 2026/11/03MITES Module

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

中文使用文档
文档目录6 节
  1. 安装
  2. 注册您的MCP客户端
  3. 插件(编辑器/运行时平面所需)
  4. 本地第一
  5. 安全
  6. 许可证

breakpoint-mcp

MCP的 主人 用于 断点MCP - - - - - - 一个 模型上下文协议 服务器,公开 戈多游戏引擎到AI编码助手跨越四个平面:无头CLI,现场直播 编辑器,Godot自己的LSP + DAP,以及运行游戏中的运行时桥。* * 295工具

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

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

安装

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

npx breakpoint-mcp init

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

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:

npm i -g breakpoint-mcp

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

注册您的MCP客户端

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

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

克劳德桌面 (claude_desktop_config.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主机、端口和超时)和一个完整的演练 在 库的自述 和 用户指南.

使用Cursor, VS Code, Windsurf或其他MCP客户端?该命令是相同的-参见 这个 兼容性 每个客户端的配置文件和格式。

插件(编辑器/运行时平面所需)

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

本地第一

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

安全

主机生成Godot二进制文件,可以运行GDScript和配置的本地命令,并且 将文件写入项目;破坏性工具已被确认。看到 安全策略 了解信任模型以及如何报告漏洞。

许可证

MIT -见 许可证. Godot, Claude/Anthropic,命名后端sdk是 各自所有者的商标;断点MCP是一个独立的项目 不隶属于或不被他们认可的。

版本与发布记录

breakpoint-mcp 共发布 51 个版本,首次发布于 2026/07/10;过去 12 个月发布了 51 个版本。

版本发布日期距今
1.89.0latest2026/11/03今天
1.88.02026/11/03今天
1.87.02026/10/011 个月前
1.86.02026/09/181 个月前
1.85.12026/09/071 个月前
1.85.02026/09/061 个月前

关于 breakpoint-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 和提交记录判断。