Tripo Studio MCP

本项目把使用者自己的 Tripo Studio 会员账号接入 Codex。它覆盖图片、3D 模型、模型后处理、绑骨与动画，并把输入和结果自动下载到本机私有画廊。

本项目不是 Tripo 官方产品，使用的是 Studio 网页当前采用的接口；网页契约变化时需要更新插件。

主要能力

• 图片生成：提示词、参考图、动态模板、五种比例、1–4 张、1K/4K、重新生成；

• 图片四视图：从 Studio 图片输出生成 front、left、back、right 四视图；

• 3D 生成：smart_mesh 智能网格与 high_detail 高精度模型，支持文字、本地单图、本地多视图、批量图片和 Studio 图片；

• 模型目录：列出模型、读取缩略图、部件、能力与动画预设；未归档模型可临时下载当前 GLB 解析部件；

• 模型导入：GLB、OBJ、FBX、STL；只归档输入与导入结果，不创建或显示质检区；

• 几何处理：部件拆分、部件补全、Triangle/Quad/Smart Poly 重拓扑；

• 纹理处理：文字/单图/多视图纹理、纹理编辑预览与应用、4K/8K 放大、PBR；

• 自动 UV：生成纹理前检测 UV；GLB 缺失 UV 时用 xatlas 补齐，OBJ/FBX/STL 缺失 UV 时交由 Studio 展开，并在付费提交前复核；

• 角色处理：自动绑骨与动画重定向；

• 本地归档：成功结果、输入快照和脱敏参数自动进入仅本机可访问的网页画廊；

• 视觉质检：图片生成直接复用或合成带标签总览，模型生成与后处理自动生成九视角总览，动画自动选取代表姿态；纯模型导入不质检。

Related MCP server: Tripo AI MCP Server

为效率设计

插件公开 35 个短而明确的工具。单项功能直接调用对应原子工具；只有确实包含多个依赖步骤时才创建工作流。

所有创建类工具都返回统一 Action。随后只调用一次 tripo_wait_action，不需要让代理分析或轮询各业务自己的生命周期。Codex 连接期间的共享后台进程负责：

• 最多 10 个远端任务并发，批量任务按实际子任务数占用容量；

• 同一模型或项目的修改自动串行；

• 登录状态巡检与掉线自动恢复；

• 结果下载、校验和画廊归档；

• 本地视觉质检的排队、缓存、失败降级和最多 2 个渲染任务并发；

• 普通 RPC 连接意外断开时保留后台工作；最后一个 Codex 生命周期连接关闭后立即退出；

• 已经提交到远端的任务不会重提，下次启动后从本地账本恢复跟踪。

并发数不在工具参数中，使用者和代理都不需要管理。

两层运行架构

插件使用同一个构建包启动两类本机进程，但它们不是同一个职责：

Codex
  └─ stdio MCP 前端：立即提供工具目录、参数 schema 和调用入口
       └─ 本机私有 RPC
            └─ 唯一 daemon：账号、浏览器、Action、Workflow、全局调度、下载和画廊

• 每个 Codex 任务各有一个轻量的 stdio MCP 前端；多个前端共享一个取得全局锁的 daemon。

• 工具目录属于 MCP 前端，不依赖 daemon 的账本、画廊或浏览器是否已经初始化。因此后台暂时不可用时，Codex 仍应看见完整工具目录。

• daemon 取得全局锁后先监听本机 RPC，再在后台初始化持久数据与服务。初始化失败时它保持可连接，并把准确、脱敏的本地错误返回给本次工具调用。

• 修复本地状态后，下一次原生工具调用会再次尝试初始化；正常运行故障不要求重启 Codex、新建任务或编写临时脚本。

• 读取和等待调用可在 RPC 断线后安全重连一次。创建或修改调用一旦开始发送就绝不自动重放；结果不明确时仍按 outcome_unknown 处理。

• 最后一个 Codex 生命周期连接关闭后，daemon 退出；以后启动会从本地持久状态恢复已存在的 Action，而不是重新提交远端任务。

快速安装

在目标电脑的 Codex 桌面版中新建任务，粘贴：

阅读 https://raw.githubusercontent.com/Ador-able/tripo-studio-mcp/main/INSTALL.md，并按文档在本机安装 Tripo Studio 插件。

安装采用仓库内的 Git marketplace：

.agents/plugins/marketplace.json

完整流程见 INSTALL.md。

基本用法

1. 首次使用或换账号时调用 tripo_set_account。插件只保存一个账号，新账号验证成功后覆盖旧账号。

2. 直接调用所需原子工具，例如 tripo_generate_model。创建工具返回已自动调度的 Action。

3. 用返回的 action_id 调用一次 tripo_wait_action。后台会持续等待远端结果和本地质检，并在正常成功响应中直接附带可检查的图片。

4. 需要查看全部输入和结果时调用 tripo_open_gallery；画廊服务本身已经随后台启动。

换号成功时，旧账号所有非终态 Action/Workflow 会立即在本地标记为 failed，以后不会重新接管。插件不取消、不轮询、不对账或自动重提旧账号的远端任务；是否重新发起由调用方决定。所有任务共用 daemon 唯一的全局 10 并发池。

tripo_generate_model 的 tier 参数区分两种生成模式：

• smart_mesh：智能网格，面向游戏和 Web 资产；

• high_detail：高精度模型。

余额只在使用者明确查询状态时读取，不参与创建流程或结果判断。Studio 返回错误码 2010 时，Action 以 INSUFFICIENT_CREDITS 失败且不会自动重试。

工具分组

• 账号与状态：tripo_get_status、tripo_set_account、tripo_clear_account

• 目录与画廊：tripo_list_models、tripo_get_model、tripo_list_images、tripo_get_image、tripo_list_templates、tripo_open_gallery

• 创建与处理：15 个原子创建工具

• Action：读取、列表、等待、安全取消、未知结果对账

• Workflow：启动、读取、列表、暂停、恢复、取消

完整工具名清单由构建生成在 plugins/tripo-studio-mcp/TOOL_INVENTORY.md；参数以 MCP 返回的工具 schema 为准。

项目结构

.agents/plugins/marketplace.json       Git marketplace
plugins/tripo-studio-mcp/              可直接安装的 Codex 插件
src/                                   TypeScript 源码
tests/                                 离线测试
docs/testing/                          实时验收与模型质检说明
scripts/build-plugin.mjs               生成自包含插件

插件包中的 mcp/server.mjs 是构建产物；安装时不需要在插件目录运行 npm install。

本地开发

要求 Node.js 22 或更高版本：

npm ci
npm run verify

常用命令：

npm run check
npm test
npm run plugin:build
npm run plugin:check
npm run test:plugin

修改源码、依赖或工具后必须运行 npm run plugin:build。不要手工编辑构建生成的 server.mjs、browsers.json、TOOL_INVENTORY.md、许可证副本或第三方声明。

进一步阅读

• 安装与本机重装

• 安全边界

• 贡献与验证

• 实时验收

• 应用内验收

• 模型质检

• 画廊视觉质检实现