Trident (Tripo 3D)

trident-mcp

一个非官方的 Tripo 3D API MCP 服务，涵盖所有已公开文档且已部署的 v3 工作流。部分端点刻意未提供，详见 docs/MCP_TOOLS.md。Agent 可以：

• 根据文本、单张图片或多个视角生成网格；
• 制作参考图和多视角图集；
• 为网格添加纹理、重新拓扑、展开 UV、分割、绑定骨骼、制作动画和转换格式；
• 生成高斯泼溅。

输出会保存为磁盘上的文件。项目以单个 Go 二进制文件通过 stdio 运行，另附带一个包含工作流技能的 Claude Code 插件。

快速开始

Claude Code。 将二进制文件放到 PATH 中，然后安装插件：

go install github.com/mordor-forge/trident-mcp/cmd/trident-mcp@latest   # or grab a release archive

/plugin marketplace add mordor-forge/claude-plugins
/plugin install trident@mordor-forge

插件会询问你的 Tripo 密钥和输出文件夹，并添加 tripo-3d 技能。之后，告诉它你想做什么，例如 “制作一个适用于游戏的低多边形宝箱，并将其导出为 FBX”。

任何 MCP 客户端：

{
  "mcpServers": {
    "trident": {
      "command": "trident-mcp",
      "env": { "TRIPO_API_KEY": "tsk_...", "MODEL_OUTPUT_DIR": "/abs/path/generated_models" }
    }
  }
}

工作原理

1. 创建任务的工具（text_to_model、rig_model、convert_model 等）会在本地验证参数、上传本地文件，并返回一个 task_id。
2. wait_for_task 会等待任务完成并发送进度通知，然后将输出保存到 <output dir>/<task_id>/。例如：model.glb、rendered_image.webp、generated_image.png、front_view.png。
3. 将 task_id 作为下一个工具的 input，即可串联步骤：图像 → 网格 → 骨骼绑定 → 动画 → FBX。

参数使用 Tripo 自己的字段名称，因此可直接参考 Tripo 文档。部分便捷字段与 Tripo 的传输格式不同，例如多视角 inputs 使用 {front, left, back, right} 映射。全部 28 个工具详见 docs/MCP_TOOLS.md。

配置

变量	默认值
TRIPO_API_KEY	必填	来自 https://platform.tripo3d.ai
MODEL_OUTPUT_DIR	~/generated_models	如果不存在则会创建
TRIPO_BASE_URL	https://openapi.tripo3d.ai/v3	中国区域密钥：https://openapi.tripo3d.com/v3

文档

需求	阅读
所有工具、参数和行为	docs/MCP_TOOLS.md
架构和 internal/tripo 模块	ARCHITECTURE.md、docs/design/tripo-module.md
领域词汇	GLOSSARY.md
贡献指南、变更方法	AGENTS.md、docs/DEVELOPMENT.md、docs/patterns/common-changes.md
运行、实时测试、故障处理	docs/OPERATIONS.md
决策	docs/adr/
安全	SECURITY.md、THREAT_MODEL.md

Tripo 条款与商标

trident-mcp 是一个独立项目，与 Tripo、VAST 或 Holymolly Ltd 无关联，也未获其认可；“Tripo”是其所有者的商标。你对 Tripo API 的使用受 Tripo 条款约束。根据这些条款：

• 使用你自己的 API 密钥，并妥善保密。
• 向他人提供共享部署或托管部署前，必须获得 Tripo 的书面授权。
• 生成模型的所有权取决于你的 Tripo 方案。

文档和技能中引用的点数价格是带日期的摘要；权威信息以 Tripo 定价页面为准。

许可证

Apache-2.0。详见 LICENSE。该许可证仅涵盖本仓库的代码，不涵盖 Tripo 服务或你生成的模型。