trident-mcp

trident-mcp は、AI支援による3Dモデル生成およびポストプロセッシングのためのGo製MCPサーバーです。

このサーバーはクライアントに依存せず、MCP互換のあらゆるクライアントで独立して動作します。コアとなる3D生成、ポーリング、ダウンロード、ポストプロセッシングツールを使用するために、追加のスキルやMCPサーバーは必要ありません。

現在はTripoバックエンドを搭載しており、以下のツールを提供しています：

• テキストから3Dへの生成

• 画像から3Dへの生成

• マルチビューから3Dへの生成

• 非同期タスクのポーリング

• モデルのダウンロード

• リトポロジー

• フォーマット変換

• スタイライズ

• モデルカタログおよびサーバー設定の確認

要件

• Go 1.25以上

• TRIPO_API_KEY に設定されたTripo APIキー

インストール

ローカルでビルドする場合:

go build ./cmd/trident-mcp

またはGoでインストールする場合:

go install github.com/mordor-forge/trident-mcp/cmd/trident-mcp@latest

設定

サーバーは環境変数から設定を読み取ります：

実行

サーバーはstdio経由でMCPと通信します：

TRIPO_API_KEY=tsk_your_key_here trident-mcp

MCPクライアント設定の例：

{
  "mcpServers": {
    "trident-mcp": {
      "command": "trident-mcp",
      "env": {
        "TRIPO_API_KEY": "tsk_your_key_here",
        "MODEL_OUTPUT_DIR": "/absolute/path/to/generated_models"
      }
    }
  }
}

ツール

生成

• text_to_3d

• image_to_3d

• multiview_to_3d

これらのツールは非同期タスクを開始します。task_status を使用して完了をポーリングし、その後 download_model を使用してタスクの出力を取得します。

ステータスとダウンロード

• task_status

• download_model

download_model はタスクの実際の出力フォーマットを保存します。別のフォーマットが必要な場合は、先に convert_format を実行してから変換タスクをダウンロードしてください。

ポストプロセッシング

• retopologize

• convert_format

• stylize

イントロスペクション

• list_models

• get_config

get_config は、アクティブなバックエンド、出力ディレクトリ、サーバーバージョンを報告します。

スキル

このリポジトリには、skills/ 配下にコンパニオンエージェントスキルも含まれています：

• skills/3d-gen/SKILL.md

• skills/multiview-3d/SKILL.md

• skills/3d-to-blender/SKILL.md

これらのスキルはオプションです。MCPサーバー自体は、どのMCPクライアントでも単体で問題なく動作します。

一部のコンパニオンスキルは、より完全な自動化パイプラインを実現するために、trident-mcp と gemini-media-mcp を組み合わせるように設計されています。その構成では、gemini-media-mcp がアイデア出し、参照画像の生成、多角的な画像作成を支援し、trident-mcp が再構築とポストプロセッシングを担当します。この組み合わせにより、アイデアから完成した3Dモデルまでのより完全なフローが可能になります。

開発

ローカルチェックを実行します：

go test ./...
go vet ./...

また、実際のTripoアップロードに対するオプトインのE2Eスモークテストもあります：

TRIPO_API_KEY=tsk_your_key_here go test -tags=e2e -run "TestE2E_" ./internal/provider/tripo/ -v

リリース

GitHub Actionsは、プッシュおよびプルリクエスト時にユニットチェックを実行し、main ブランチおよびバージョンタグに対してE2Eスモークテストを実行します。タグ付けされたリリースはGoReleaserでビルドされます。

アーティファクトにはリリースバージョンが刻印されるため、バイナリとMCP実装のメタデータは常に同期されます。