Beckett 是一个直接嵌入 Godot 4 编辑器的 MCP（Model Context Protocol）服务器，以 GDScript EditorPlugin 形式实现，AI 代理（如 Claude Code、Cursor）通过 HTTP 与编辑器交互，无需 Node/Python 桥接、无需第二个进程、无需云端。当前仓库为免费 MIT 许可的 Lite 版，提供完整的“检查 → 编写 → 运行 → 看见”开发闭环（56 个工具），支持 GDScript 和 C#。Full 版为付费商业产品，增加自主试玩能力。
用途方面，Beckett 面向希望在 Godot 编辑器内由 AI 代理协助检查、编写、运行并观察游戏的开发者。基础版即可让 AI 看到运行中的游戏：截图、读取实时远程场景树与节点状态、轮询性能监视器、查看游戏日志。付费 Full 版则让 AI 成为试玩者，可驱动输入、点击 2D/3D 和 UI 并断言结果。
主要能力方面，Lite 版包含以下工具组：反射/发现（get_godot_version、find_classes、describe_class、find_methods、describe_object、set_property、call_method、get_scene_tree）；场景编写（create_node、delete_node、rename_node、reparent_node、duplicate_node、move_node、instance_scene、save_scene、open_scene，均通过 EditorUndoRedoManager 支持撤销）；GDScript 开发闭环（validate_script、write_script、script_patch、read_script、attach_script，采用先验证后写入）；C#/.NET 开发闭环（build_csharp 执行 dotnet build 编译检查，返回结构化 file:line:col 与 CS 代码诊断，write_script 识别 .cs，C# [GlobalClass] 类型可被反射）；信号（connect_signal、disconnect_signal、list_signals）；资源资产（create_resource、set_resource）；文件/项目（read_file、write_file、list_dir、search_files、rescan_filesystem、get_project_setting、set_project_setting）；运行循环（play_scene、stop_scene、get_play_state、wait_until、logs_read）；运行时观察（screenshot、ui_snapshot、get_remote_tree、find_nodes、wait_for_node、runtime_get_property、monitor_properties、get_performance_monitors、game_logs）；渲染诊断（render_probe、set_debug_draw）；项目/编写辅助（get_project_statistics、apply_template、batch_execute、doctor、help）。同时提供 MCP Resources（scene://tree、scene://selection、project://settings、assets://list、log://output、audit://recent）和 MCP Prompts（inspect_node、audit_scene、setup_2d_player、fix_script_errors、build_test_fix、make_game）。
Full 版新增：驱动类工具（simulate_input、click_button_by_text、click_control、click_node3d、click_world、滚动/拖拽、get_control_rect、find_ui_elements、runtime_call、runtime_set_property、record_input、replay_input）；验证类工具（assert_node_state、assert_screen_text、assert_scene、compare_screenshots、test_run）；编写与发布工具（animation_manage、scatter_nodes、background export_project + job_status、find_unused_resources、detect_circular_dependencies、asset_lib_search、asset_lib_info、asset_lib_install）；以及 46 个技能知识包（通过 list_skills / load_skill 加载，涵盖 gdscript、particles、animation、ui、physics、multiplayer、mobile 等）。
使用方式：在 Godot 中打开 Asset Store 标签（4.7 之前为 AssetLib），搜索“Beckett”并安装（Asset Store 列表，Asset Library #5296），或手动将 addons/beckett/ 复制到项目。在 Project → Project Settings → Plugins 中启用，支持 Godot 4.2+（推荐 4.4+）。启用后自动启动服务器并写入 .mcp.json。可通过 beckett/autostart=false、beckett/auto_write_client_config=false 关闭自动行为；环境变量包括 BECKETT_PORT（默认 8770）、BECKETT_TOKEN、BECKETT_READONLY=1、BECKETT_ALLOWLIST、BECKETT_CONFIRM_DESTRUCTIVE=1。对于 Claude Code，在项目中运行 claude 即可，自动写入的 .mcp.json 会完成连接（/mcp → beckett）；对于 Cursor 等，可指向 http://127.0.0.1:8770/mcp（Streamable HTTP）或使用面板中的 Connect Detected Clients 按钮。
适用场景：需要在 Godot 4 项目中使用 AI 代理进行代码编写、场景编辑、运行调试、截图观察和日志诊断的开发者。Lite 版免费开源，适合观察和诊断；Full 版适合需要 AI 自动试玩、断言结果和批量任务的用户。
限制与注意事项：本仓库为免费 Lite 版，许可为 MIT。Full 版为独立商业产品，一次性购买（15 美元）含终身更新，购买地址见官方 itch.io 页面。Beckett 是第三方工具，与 Godot Foundation 无隶属或背书关系，“Godot”是 Godot Foundation 的商标。安全方面：仅限本地主机，进行严格的 Host 与 Origin 检查（防 DNS 重绑定），新项目使用每项目令牌，文件读取限定在项目内，提供只读/允许列表/确认破坏性操作等门控，详细说明见 SECURITY.md。Lite 版附带游戏侧运行时（addons/beckett/runtime/mcp_runtime.gd，MIT 源码），Full 版的驱动工具会使用该运行时并理解驱动命令；Lite 版工具不会发送这些命令，其桥接也会拒绝它们。这是产品边界而非沙箱。系统要求为 Godot 4.2+（推荐 4.4+），已在 4.4.1、4.6.2 和 4.7 上验证，CI 测试覆盖 Windows、Linux 和 macOS。
