breakpoint-mcp
MCP的 主人 用于 断点MCP - - - - - - 一个 模型上下文协议 服务器,公开 戈多游戏引擎到AI编码助手跨越四个平面:无头CLI,现场直播 编辑器,Godot自己的LSP + DAP,以及运行游戏中的运行时桥。* * 295工具
- 6 . MCP资源**,构建稳定
@modelcontextprotocol/sdk1.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是一个独立的项目 不隶属于或不被他们认可的。