用途:Creator Hub 在应用内运行一个 MCP 服务器(localhost、streamable HTTP、bearer token),其工具可读取并修改编辑器中当前打开的场景。改动作用于实时引擎、立即显示在视口、自动保存到 assets/scene/main.composite,且每一步都是用户可撤销的操作。同一服务器也驱动 Creator Hub 内置 AI 助手,并可暴露给任何支持 MCP 的外部工具。
接入方式:在 Creator Hub 的 AI 助手内(Settings > AI > Enable AI Assistant,自 0.50.0 起默认开启)已预接线,应用会启动 claude / codex / cursor-agent / gemini CLI 并注册服务器为 creator-hub。在其他工具(Claude Code、Cursor、Codex、Claude Desktop 等)中需连接正在运行的 Creator Hub,用户从 Settings > AI > Expose AI assistant MCP server 复制 JSON 片段。在 Claude Code 中工具名为 mcp__creator-hub__<tool>,其他客户端使用裸名(scene_state、create_entity 等)。
主要能力:读取类工具包括 get_project_info、scene_state、entity_detail、get_selection、get_scene_metrics、editor_screenshot;修改类包括 create_entity、remove_entity、set_parent、set_component、remove_component;资产类包括 search_catalog、place_smart_item;脚本类 attach_script;设置类 get_scene_settings / set_scene_settings;预览类 launch_preview、preview_status、stop_preview 及 explorer_* 动态工具;聊天类 ask_user。
关键规则:MCP 可用时不要手写 main.composite、main.crdt 或 scene.json,编辑器会整体重生成这些文件,手改会被静默丢弃。创建标准对象前先 search_catalog 查找 Smart Item(如灯光、交互家具、媒体、触发器)。用户已有媒体建议从 Local Assets 拖入视口。
限制:工具失败(无编辑器窗口、连接被拒、401)时说明 Creator Hub 已关闭或重启(URL 与 token 每次启动轮换),不要静默回退到改文件。数据层可能静默死亡而 MCP 仍正常应答,因此每批修改后需检查 assets/scene/main.composite 的修改时间是否推进。thumbnail 不在 set_scene_settings 输入 schema 中。scene_state 截断为前 200 个实体。其余细节暂未提供。