MCP & co-directorMCP 与 AI 副导演
The same Aholo APIs, driven from your editor or from a sentence. Holorra ships a ready
.mcp.json for the official @manycore/aholo-sdk-mcp server, and the studio's co-director turns a plain-language brief into an ordered plan of those MCP tool calls.同一套 Aholo API,既能在编辑器里调用,也能用一句话驱动。Holorra 为官方 @manycore/aholo-sdk-mcp 服务器准备了现成的 .mcp.json;创作台里的 AI 副导演则把一段自然语言描述转成按顺序排列的 MCP 工具调用计划。Use Aholo MCP in Claude Code or Cursor在 Claude Code 或 Cursor 中使用 Aholo MCP
The repository root contains this file. Put your key in place of the placeholder (or set it in your shell) and open the project in an MCP client.代码仓库根目录下就有这个文件。把占位符换成你的密钥(或在 shell 中设置),再用 MCP 客户端打开项目即可。
.mcp.json
{
"mcpServers": {
"aholo-sdk-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@manycore/aholo-sdk-mcp"],
"env": { "AHOLO_API_KEY": "<your key>", "AHOLO_REGION": "com" }
}
}
}The MCP hub has copy buttons for Claude Code, Claude Desktop and Cursor, plus a playground that shows each tool's schema and sample arguments.MCP 中心提供 Claude Code、Claude Desktop 和 Cursor 的一键复制按钮,还有一个演练场,可以查看每个工具的 schema 和示例参数。
What the server exposes服务器提供的工具
@manycore/aholo-sdk-mcp 1.10.0 registers 26 tools in three families:@manycore/aholo-sdk-mcp 1.10.0 注册了 26 个工具,分为三类:
| Family类别 | Tools工具 |
|---|---|
| World世界 | world_generate, world_reconstruct, world_reconstruct_space / _object and their _from_files variants, world_get, world_list, world_wait_for, world_inspect_local_mediaworld_generate、world_reconstruct、world_reconstruct_space / _object 及其 _from_files 变体、world_get、world_list、world_wait_for、world_inspect_local_media |
| Lux3D | lux3d_text_to_3d, lux3d_img_to_3d, lux3d_img_to_3d_from_file, lux3d_image_to_four_view, lux3d_multimodal_to_image, lux3d_part_split, lux3d_articulation_animation, lux3d_humanoid_auto_rig, lux3d_humanoid_animation_retarget, lux3d_material_transfer, lux3d_multi_format_export, lux3d_get_task, lux3d_list_tasks, lux3d_wait_for_task |
| Assets资产 | upload_asset |
- Long jobs do not block. Submit returns a task or world ID at once; check with
lux3d_get_task/world_get, and only wait when you mean to.长任务不会阻塞。提交后立即返回任务 ID 或世界 ID;用lux3d_get_task/world_get查询进度,只在确实需要时才等待。 - Local files stay local. File tools take a
localPath; the server uploads it, so binaries do not pass through the MCP protocol.本地文件留在本地。文件类工具接收localPath,由服务器负责上传,二进制数据不经过 MCP 协议。
The in-app co-director应用内的 AI 副导演
Open Co-director in the studio's right dock and describe the scene. For example:在创作台右侧面板中打开 AI 副导演,描述你想要的场景。例如:
"Walk the actor to the espresso machine and open the hood."
- Plan:
POST /api/aholo/directorreads the brief and returns an ordered list of MCP tool calls, each with its SDK method, arguments and a one-line rationale.规划:POST /api/aholo/director读取描述,返回一组按顺序排列的 MCP 工具调用,每条都附有对应的 SDK 方法、参数和一句话理由。 - Apply: the stage is updated to match the plan: world, prop, explode level, articulation, actor clip, camera mode, and camera-path playback.应用:舞台按计划更新,包括世界、道具、爆炸程度、关节化、角色动作片段、镜头模式和镜头路径回放。
- Receipts: each planned call is listed with its tool name, SDK method and arguments.调用回执:逐条列出计划中的每个调用,以及它的工具名、SDK 方法和参数。
The planner is deterministic: it matches keywords (worlds, props, actions, clip names) to tool calls, so the same brief always gives the same plan and it needs no LLM key. Briefs can be in English or Chinese. It plans; it does not run the jobs. To run them, use the Lux3D and World tabs or an MCP client.规划器是确定性的:它把关键词(世界、道具、动作、动作片段名称)匹配到工具调用,所以同样的描述总会得到同样的计划,也不需要 LLM 密钥。中英文描述都可以。它只做规划,不会实际运行任务。要运行任务,请使用 Lux3D 和世界标签页,或 MCP 客户端。