Trident (Tripo 3D)

io.github.mordor-forge由 GitHub 账号 mordor-forge 发布v0.4.0更新于 Oct 26, 2026

Unofficial MCP server for the Tripo 3D API: text/image to 3D, texturing, rigging, conversion

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

Tripo 3D API 的非官方 MCP 服务器,让助手生成、贴图、绑定骨骼、制作动画并转换 3D 模型,结果保存到本地磁盘。

可以做什么
  • 根据文本、单张图片或多视角图片生成网格模型,并生成参考图与多视角图集
  • 对网格进行贴图、重拓扑、UV 展开、分割、绑定骨骼、制作动画和格式转换,并生成高斯泼溅
  • 创建任务并返回 task_id,用等待工具获取进度通知,并把 GLB、FBX、渲染图等输出保存到按任务划分的目录
  • 把上一个任务的 task_id 作为下一个工具的输入来串联流程,例如图片到网格、绑定、动画再到 FBX
适用场景
适合希望助手通过 Tripo 托管 API 产出或后处理 3D 素材的场景,例如游戏用道具、带贴图或骨骼的角色、格式转换等,无需离开对话即可完成。
运行要求
以本地进程通过 stdio 运行,提供 Go 二进制或 Docker 镜像;必须通过 TRIPO_API_KEY 提供 Tripo API 密钥,MODEL_OUTPUT_DIR 指定输出目录(默认 ~/generated_models),TRIPO_BASE_URL 可切换到中国区端点。需要能访问 Tripo API 的网络。
安装前请注意
需要 Tripo API 密钥(TRIPO_API_KEY)并须妥善保密;Tripo 任务会消耗额度,README 说明文档中的额度价格只是带日期的摘要,以 Tripo 定价页为准。本地文件会上传到 Tripo,生成的模型会写入磁盘,生成模型的所有权取决于你的 Tripo 套餐。向他人提供共享或托管部署需获得 Tripo 书面授权。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Trident (Tripo 3D),将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

trident-mcp

[Go] [License]

An unofficial MCP server for the Tripo 3D API that covers every documented, deployed v3 workflow. A few endpoints are deliberately left out; they are listed in docs/MCP_TOOLS.md. Agents can:

  • generate meshes from text, one image or several views;
  • make reference images and multiview sets;
  • texture, retopologize, UV-unwrap, segment, rig, animate and convert meshes;
  • produce Gaussian splats.

The outputs land as files on disk. It ships as one Go binary over stdio, plus a Claude Code plugin with a workflow skill.

[Potion bottle generated with the Tripo v3 multiview pipeline]

Quick start

Claude Code. Put the binary on your PATH, then install the plugin:

bash
go install github.com/mordor-forge/trident-mcp/cmd/trident-mcp@latest   # or grab a release archive
text
/plugin marketplace add mordor-forge/claude-plugins/plugin install trident@mordor-forge

The plugin asks for your Tripo key and output folder, and adds the tripo-3d skill. Then ask for what you want, e.g. "make a game-ready low-poly treasure chest and export it as FBX".

Any MCP client:

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

How it works

  1. A task-creating tool (text_to_model, rig_model, convert_model, …) validates its arguments locally, uploads any local files, and returns a task_id.
  2. wait_for_task waits with progress notifications, then saves the outputs to <output dir>/<task_id>/. For example: model.glb, rendered_image.webp, generated_image.png, front_view.png.
  3. Pass a task_id as the next tool's input to chain steps: image → mesh → rig → animation → FBX.

Arguments use Tripo's own field names, so Tripo's docs apply to them directly. A few convenience fields differ from Tripo's wire format, such as multiview inputs given as a {front, left, back, right} map. See docs/MCP_TOOLS.md for all 28 tools.

Configuration

VariableDefault
TRIPO_API_KEYrequiredFrom https://platform.tripo3d.ai
MODEL_OUTPUT_DIR~/generated_modelsCreated if missing
TRIPO_BASE_URLhttps://openapi.tripo3d.ai/v3China-region keys: https://openapi.tripo3d.com/v3

Documentation

NeedRead
Every tool, argument and behaviourdocs/MCP_TOOLS.md
Architecture and the internal/tripo moduleARCHITECTURE.md, docs/design/tripo-module.md
Domain vocabularyGLOSSARY.md
Contributing, change recipesAGENTS.md, docs/DEVELOPMENT.md, docs/patterns/common-changes.md
Running, live tests, failure handlingdocs/OPERATIONS.md
Decisionsdocs/adr/
SecuritySECURITY.md, THREAT_MODEL.md

Tripo terms and trademarks

trident-mcp is an independent project. It is not affiliated with or endorsed by Tripo, VAST or Holymolly Ltd, and "Tripo" is a trademark of its owner. Your use of the Tripo API is governed by Tripo's terms. Under them:

  • Use your own API key, and keep it private.
  • Tripo's written authorization is required before offering a shared or hosted deployment to other people.
  • Ownership of generated models depends on your Tripo plan.

Credit prices quoted in the docs and skill are dated summaries; Tripo's pricing page is authoritative.

License

Apache-2.0. See LICENSE. The license covers this repository's code, not Tripo's service or the models you generate.

来源:README.md,提交 c5540cd

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.4.0最新Oct 18, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分