安装
Enable the Beckett EditorPlugin (writes .mcp.json)适合谁
你在 Godot 4 编辑器里做 GDScript 或 C# 游戏,希望 Claude 或 Cursor 直接检查、编写、运行并看见场景,而不想再挂 Node 或 Python 桥、也不想第二进程或云端。Beckett 是嵌在编辑器里的 GDScript EditorPlugin,零 sidecar。
免费 MIT Lite 覆盖完整的 inspect → author → run → SEE 循环,共 55 个工具。本页没有点名这 55 个工具,因此不要编造场景树或脚本工具名。
官方仓库单独一行:
https://github.com/beckettlab/beckett-godot-mcp
3 分钟完成第一次尝试
只走官方的一步安装:在 Godot 4 里启用该插件。启用后服务会自动启动,并写入 .mcp.json,让 claude 或 Cursor 无需手改配置即可连接。不需要安装 Node.js。
前置条件:本机已有 Godot 4 编辑器,并能打开带该 addon 的项目。除 addon 外没有别的要装。运行时是编辑器主线程上轮询的 TCPServer HTTP/JSON-RPC。
配置位置:Godot 插件开关,以及项目里自动生成的 .mcp.json。不要手写一份与自动文件冲突的服务器配置。若不想自动启动,官方给出 opt-out:beckett/autostart=false。
低风险第一步:先做 inspect,只观察项目,不要 author 或 run。成功信号是插件启用后服务起来、.mcp.json 出现,并且 Claude 或 Cursor 能连上。本页无具体 inspect 工具名,不要编造。
安全边界:只监听 localhost,带 Origin 校验(防 DNS-rebind),可选 bearer token,以及 read-only / allowlist / confirm-destructive 门闩。不要把 localhost 理解成无网络或无本地读取;它仍在本机打开 HTTP,并读写编辑器里的项目。readOnlyHint 不是零风险。
准备改场景或跑游戏前,先确认 destructive 需要确认。author 与 run 会改项目或启动游戏,官方未给撤销命令。
使用案例
案例一:先检查当前项目。启用插件,让客户端走 .mcp.json 连上,只使用 inspect。55 个工具里哪些属于 inspect 未列出。GDScript 与 C# 都在 Lite 范围内。
案例二:再编写或运行前,打开确认门闩。官方循环是 inspect → author → run → SEE。author 会改项目,run 会在编辑器里跑游戏。有 confirm-destructive 与 allowlist。没有工具名就不要调用写入。可选 bearer token 未写如何生成。
使用边界
零 sidecar 不等于没有本机 HTTP。无云、无第二进程,但仍绑定 localhost。自动写 .mcp.json,可用 beckett/autostart=false 关闭自启。55 个工具未点名。Lite 是 MIT 免费版。官方未写端口号、Godot 小版本和卸载后如何删 .mcp.json。