Trident (Tripo 3D)
Unofficial MCP server for the Tripo 3D API: text/image to 3D, texturing, rigging, conversion
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
ghcr.io/mordor-forge/trident-mcp:0.4.0claude mcp add trident-tripo-3d -- docker run -i --rm ghcr.io/mordor-forge/trident-mcp:0.4.0
{
"mcpServers": {
"trident-tripo-3d": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mordor-forge/trident-mcp:0.4.0"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
trident-mcp
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.
Quick start
Claude Code. Put the binary on your PATH, then install the plugin:
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
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:
{
"mcpServers": {
"trident": {
"command": "trident-mcp",
"env": { "TRIPO_API_KEY": "tsk_...", "MODEL_OUTPUT_DIR": "/abs/path/generated_models" }
}
}
}
How it works
- A task-creating tool (
text_to_model,rig_model,convert_model, …) validates its arguments locally, uploads any local files, and returns atask_id. wait_for_taskwaits 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.- Pass a
task_idas the next tool'sinputto 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
| Variable | Default | |
|---|---|---|
TRIPO_API_KEY | required | From https://platform.tripo3d.ai |
MODEL_OUTPUT_DIR | ~/generated_models | Created if missing |
TRIPO_BASE_URL | https://openapi.tripo3d.ai/v3 | China-region keys: https://openapi.tripo3d.com/v3 |
Documentation
| Need | Read |
|---|---|
| Every tool, argument and behaviour | docs/MCP_TOOLS.md |
Architecture and the internal/tripo module | ARCHITECTURE.md, docs/design/tripo-module.md |
| Domain vocabulary | GLOSSARY.md |
| Contributing, change recipes | AGENTS.md, docs/DEVELOPMENT.md, docs/patterns/common-changes.md |
| Running, live tests, failure handling | docs/OPERATIONS.md |
| Decisions | docs/adr/ |
| Security | SECURITY.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.
الأسئلة الشائعة
ما هو Trident (Tripo 3D)؟
Unofficial MCP server for the Tripo 3D API: text/image to 3D, texturing, rigging, conversion
كيف أثبّت Trident (Tripo 3D)؟
يعمل على جهازك. في Claude Code: claude mcp add trident-tripo-3d -- docker run -i --rm ghcr.io/mordor-forge/trident-mcp:0.4.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Trident (Tripo 3D) إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Trident (Tripo 3D) مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.
من يصون Trident (Tripo 3D)؟
ينشره mordor-forge. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.