Trellis MCP

🚀 Trellis MCP サーバー

Trellis MCP は、Trellis と AI アシスタントの間のインターフェースを提供し、モデルコンテキストプロトコル (MCP) を介して統合を実現します。

免責事項

このプロジェクトは、非常に 基本的な MCP と Trellis の統合を示しています。Trellis は、軽量でオープンソースのテキストから 3D 画像、または画像から 3D モデルを生成する 3DAIGC（三次元人工知能生成コンテンツ）モデルです。他の既存の Rodin の Blender - MCP 統合 や TriPo 統合 と比較して、以下の利点があります：

• 高速かつメモリ効率が良い：ローカルで Trellis をデプロイ（8GPU 以上の VRAM が必要） でき、~15 秒（より多くの VRAM で 10 秒に短縮可能）でテキストからテクスチャ付きのメッシュを生成できます。
• 無料：Rodin/Meshy/TriPo などの高価な API の費用を支払う必要がありません。

ただし、以下の制限があります：

• Trellis はオープンソースで、既成の API プロバイダーがないため、自分でデプロイする必要があります（README を参照）。
• API/Prompt は完全にテスト/チューニングされていないため、安定性の問題がある可能性があります。

したがって、自己責任で使用してください。

🎬 デモ

単一のオブジェクトを生成する最小限のデモです。より複雑なプロンプトと Blender - MCP の統合は最適化中です。

✨ 主な機能

• [x] Trellis API を使用して自然言語（テキスト）から 3D アセットを生成し、Blender にインポートする
• [ ] Trellis API を使用して自然言語（テキスト）から与えられた 3D メッシュにテクスチャ/マテリアルを生成し、Blender にインポートする

📈 開発計画

前提条件

• Python 3.10 以上
• Blender
• Trellis Blender プラグイン
• Trellis API バックエンド
• Claude / Cursor（推奨）/ Windsurf

📦 インストール

1. Trellis Blender プラグイン

1. ここ から Trellis Blender プラグインをダウンロードします。
2. Blender を開き、「編集」 -> 「設定」 -> 「アドオン」 -> 「ファイルからインストール」を選択し、ダウンロードしたプラグインを選択してインストールします。
3. 3D ビューで、「ビュー 3D」 > 「サイドバー」 > 「TRELLIS」 -> 「MCP サーバーを起動」を選択します。

2. API バックエンドの設定

Trellis はオープンソースのテキストから 3D モデルを生成するモデルなので、README に従って Trellis API バックエンドを自分でデプロイする必要があります。

# API ブランチの trellis をクローンする
git clone https://github.com/FishWoWater/TRELLIS
# TRELLIS ディレクトリに移動した後、以下のコマンドを実行する
python manage.py runserver

3. Python パッケージのインストール

ターミナルで以下のコマンドを実行して、必要な Python パッケージをインストールします：

pip install trellis-mcp

設定例

MCP サーバーの起動

Blender を開き、Trellis プラグインの MCP サーバーを起動します。

💻 使用例

基本的な使用法

1. Blender で Trellis プラグインを有効にします。
2. MCP サーバーを開きます。
3. AI アシスタントを使用して、MCP プロトコルを介して Trellis とやり取りします。

高度な使用法

• カスタムメッシュ生成パラメーターをサポートします。
• より多くの機能をサポートするための拡張可能なプラグインアーキテクチャを備えています。

基本的な使用法

from trellis.mcp import GridGenerator

# 簡単な立方体メッシュを作成する
grid = GridGenerator.create_cube(length=1.0, width=1.0, height=1.0)

高度な使用法

from trellis.mcp import TextureApplicator

# メッシュにテクスチャを適用する
TextureApplicator.apply_texture(grid, texture_path="path/to/texture.png")

❓ 問題とサポート

ヘルプが必要な場合や問題を報告する場合は、GitHub リポジトリ で ISSUE を提出してください。

貢献

貢献を歓迎します！このプロジェクトに参加する方法については、CONTRIBUTING.md ファイルを参照してください。