Trident (Tripo 3D)

trident-mcp

ドキュメント化され、デプロイされているすべての v3 ワークフローに対応する、Tripo 3D API 用の非公式 MCP サーバーです。一部のエンドポイントは意図的に対象外としており、docs/MCP_TOOLS.md に記載しています。エージェントは次のことができます。

• テキスト、1 枚の画像、または複数の視点からメッシュを生成する；
• 参照画像やマルチビューセットを作成する；
• メッシュにテクスチャを適用し、リトポロジー、UV 展開、セグメント分割、リギング、アニメーション、変換を行う；
• ガウシアンスプラットを生成する。

出力はディスク上のファイルとして保存されます。stdio 経由で動作する単一の Go バイナリと、ワークフロースキルを備えた 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. 次のツールの input に task_id を渡して、各ステップを連結します：画像 → メッシュ → リギング → アニメーション → FBX。

引数には Tripo 独自のフィールド名を使用するため、Tripo のドキュメントをそのまま参照できます。マルチビューの inputs を {front, left, back, right} マップで指定するなど、一部の便利なフィールドは Tripo のワイヤ形式と異なります。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 のサービスや生成したモデルには適用されません。