TapTap Maker MCP 接入说明

本文面向已经拥有 TapTap Maker 限定测试资格的星火 2.0/WasiCore 用户，说明如何让自己的 AI 工具调用 Maker 的图片、模型、视频、音乐等资产生成能力。

前提

• 用户必须已经有 TapTap Maker 限定测试资格/权益，并具备有效登录环境或 token。星火 2.0 开放测试资格不等于 Maker 资格。
• 本机需要可运行 npx，并且当前 AI 客户端支持 MCP。
• 本流程只把 Maker 当作资产生产工具链；WasiCore 项目仍按 WasiCore SDK 文档、资源路径和调试流程开发。

安装 MCP

在终端运行：

npx -y @taptap/maker install --ide codex,cursor,claude

安装后重启 AI 客户端或重新加载 MCP 连接。若 AI 会话中已经能看到 generate_image、batch_generate_images、edit_image、create_3d_asset、create_video_task、text_to_music 等 Maker 工具，本步骤可以跳过。以实时工具目录为准，旧版 create_3d_model_task / query_3d_model_task 不保证仍然提供。

这个安装是机器/IDE 级配置：它把 Maker MCP server 注册到 Codex、Cursor、Claude 等客户端，使 AI 助手可以直接调用 Maker 工具。它不会授予 Maker 测试资格，也不会把当前目录初始化成 Maker 项目。

初始化 Maker 资产工作区

当需要把生成资产落到本地并保留 Maker 元数据时，在选定的资产工作区运行：

npx -y @taptap/maker init

建议优先使用单独的 Maker 资产工作区，或在游戏项目中明确创建一个专门用于资产生产的子目录。不要在生产中的 WasiCore 项目根目录盲目初始化，除非用户明确接受 Maker 生成的元数据文件。

安装 MCP 不等于绑定工作区。生成工具要求目标目录存在 .maker-mcp/config.json；星火新项目不会自动拥有这份 Maker 绑定。初始化时选择已有 Maker 项目，只有明确需要新建 Maker 项目时才创建。调用工具时可用 target_dir 指定资产工作区，无需修改用户级 MCP 配置的 cwd。

若 CLI 返回 PAT_EXPIRED，运行官方登录流程：

npx -y @taptap/maker login

在打开的官方页面完成登录并创建 token，CLI 会自动接收和保存；不用把 token 复制到对话或星火项目中。

当前生模型工具使用 create_3d_asset：action=start 提交，action=query 用返回的 asset_id 查询。简单测试道具可选 generation_strategy=direct；需要审阅预览时选 reviewed，展示预览并等用户确认后才 action=continue。查询间隔遵循工具返回的 poll_after_seconds。

在 WasiCore 项目中使用生成资产

生成后按 WasiCore 项目资源路径导入：

• UI 图片、Canvas 图片、图标、2D 精灵：放入 ui/image/... 或 ui/icon/...，代码/数据路径写 image/... 或 icon/...。
• 自定义音频或音乐：放入 res/sound/custom/...，路径写 sound/custom/...。
• 自定义粒子纹理或 .effect：放入 res/effect/custom/...，路径写 effect/custom/...。
• 3D 模型：Maker 生模型 MCP 交付 MDL 资源包，包内可包含模型、Maker XML prefab、材质、贴图与 .meta 文件。具体本地目录以工具返回结果为准。不要承诺工具会输出 FBX/GLB，也不要让只有 MDL 的用户走 FBX 导入；直接使用已有网格，完成星火 prefab 和材质适配。

Maker 的 XML prefab 与 UUID 引用不能直接当作星火 JSON prefab。静态装饰物需解析 .meta 对应关系，包装为项目 res/deco/<唯一名称>/model.prefab，并适配材质、贴图通道、尺寸与朝向。已有 MDL 包无需再次转换网格，但 prefab 和材质仍须适配。完整步骤见 模型导入、资源库预览与装饰物放置。

编辑器提供 resource_import_model_package 时，优先用它完成静态模型包的 UUID 解析、prefab 包装和材质适配；再通过依赖诊断、resource_open_preview 和地编放置检查结果。完整 MCP 流程见 项目模型资源包导入。导入项目 res 后不需要资源统计。

项目文件在美术资源库的「项目资源」中查看：展开道具目录，选中 model.prefab 预览。地编打开「素材」面板，选择「项目资源」，把 prefab 条目拖进场景作为装饰物放置。裸 MDL 与 Maker 原始 XML prefab 不能直接完成这一步。AI 应交付能够预览、尺寸朝向正确、可放置的模型，并给出准确文件路径。

详细路径规则见 项目资源路径指南。如果编辑器调试正常但发布后缺资源，继续看 发布资源缺失排查指南。

Agent Skill

AI 处理相关任务时应读取 TapTap Maker 资产生成 Skill。