Tripo Studio MCP

一个面向 ChatGPT/Codex 桌面版的本地 Tripo Studio 插件：使用你自己的 Studio 登录态完成图片与 3D 生成、模型管理和后处理，并用严格的单次提交保险丝避免重复扣费。

非 Tripo 官方项目。它依赖 Studio 当前网页接口，前端改版后可能需要更新。

像 ChatCut 一样安装

在 ChatGPT/Codex 桌面版的新任务中粘贴下面这句话：

阅读 https://raw.githubusercontent.com/Ador-able/tripo-studio-mcp/main/INSTALL.md，帮我安装 Tripo Studio 插件并创建一个新任务。

安装说明会让代理完成 Git marketplace 添加、插件安装、运行时检查、状态验证和首个 Tripo 任务创建。网页端和隔离的云端任务不能修改你电脑上的插件目录。

能力

• Studio 图片生成、动态模板、参考图、重新生成和立方体四视图；
• Nexus 智能网格及高精度文本、单图、多视图、批量 3D 生成；
• 模型目录、缩略图、本地 GLB/OBJ/FBX/STL 导入；
• 部件拆分与补全、Triangle/Quad/Smart Poly 重拓扑；
• 纹理生成、Magic Brush 预览、PBR、4K/8K 放大；
• 自动绑骨、动画重定向和真实格式下载；
• 输入快照、参数、哈希与结果的本地私有 provenance 画廊。

插件目前暴露 100 个 MCP 工具。精确列表由构建脚本自动生成在 TOOL_INVENTORY.md。

安全设计

• 新安装默认关闭付费操作和模型导入；
• 首次配置写入用户数据目录，不修改插件缓存，升级后仍保留；
• 所有远端写操作都执行 prepare/stage → 显式确认 → submit 一次 → wait/sync；
• submit 不自动重试，歧义结果进入 outcome_unknown，只能对账和 reconcile；
• JWT 只驻留 MCP 进程内存，不写入日志、账本或 Git；
• 本地画廊只绑定 127.0.0.1，并使用进程内随机令牌；
• 输入和输出限制在用户明确配置的目录中。

干净的仓库结构

.agents/plugins/marketplace.json       Git marketplace
plugins/tripo-studio-mcp/              可直接安装的 Codex 插件
  .codex-plugin/plugin.json
  .mcp.json
  mcp/server.mjs                       自包含运行时（构建产物）
  skills/tripo-studio/SKILL.md
src/                                   MCP TypeScript 源码
tests/                                 离线与 stdio 黑盒测试
scripts/build-plugin.mjs               生成运行时、工具清单和第三方声明
docs/testing/                          明确隔离的实时验收文档

插件不提交 node_modules，也不依赖开发机上的个人插件目录。mcp/server.mjs 把运行依赖编译成单文件，并由测试以真实 MCP stdio 方式再次启动验证。

本地开发

要求 Node.js 22+：

npm ci
npm run verify

常用命令：

npm run check          # TypeScript 类型检查
npm test               # 完整离线测试
npm run plugin:build   # 重建可安装插件
npm run plugin:check   # 检查清单、路径、版本、凭证与运行时
npm run test:plugin    # 对自包含 bundle 做 MCP 黑盒测试

plugin:build 会更新五个生成文件：mcp/server.mjs、browsers.json、LICENSE、TOOL_INVENTORY.md 和 THIRD_PARTY_NOTICES.md。不要手工编辑它们。

文档

• 代理可执行安装说明
• 贡献与发布约定
• 安全与漏洞报告
• 实时 E2E 测试
• 应用内浏览器验收
• 模型结构与视觉质检

真实付费 campaign 已有持久记录。不要仅为了复现文档而重新扣费；只有在接口变更或新增能力确实需要时，才按实时测试文档中的一次性授权协议运行。