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»).

OCI package ghcr.io/mordor-forge/trident-mcp:0.4.0
Claude Code
claude mcp add trident-tripo-3d -- docker run -i --rm ghcr.io/mordor-forge/trident-mcp:0.4.0
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "trident-tripo-3d": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/mordor-forge/trident-mcp:0.4.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. trident-mcp
  2. Quick start
  3. How it works
  4. Configuration
  5. Documentation
  6. Tripo terms and trademarks
  7. License

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

  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.

الأسئلة الشائعة

ما هو 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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.