Blender Open MCP

ブレンダーオープンMCP

blender-open-mcp Model Context Protocol (MCP) を用いて Blender とローカル AI モデル ( Ollama経由) を統合するオープンソース プロジェクトです。これにより、自然言語プロンプトで Blender を操作し、AI の力を活用して 3D モデリング作業を支援することができます。

特徴

• **自然言語で Blender を制御する:**ローカルで実行されている Ollama モデルにプロンプトを送信して、Blender でアクションを実行します。
• MCP 統合: AI モデルと Blender 間の構造化された通信にモデル コンテキスト プロトコルを使用します。
• Ollama サポート: Ollama と連携してローカル モデルの管理を容易にするように設計されています。
• **Blender アドオン:**ユーザー インターフェイスを提供し、サーバーとの通信を処理する Blender アドオンが含まれています。
• PolyHaven 統合 (オプション): AI プロンプトを介して、 PolyHavenから Blender 内で直接アセット (HDRI、テクスチャ、モデル) をダウンロードして使用します。
• 基本的な3D操作:
  • シーンとオブジェクトの情報を取得する
  • プリミティブを作成する
  • オブジェクトの変更と削除
  • 材料を適用する
• **レンダリング サポート:**ツールを使用して画像をレンダリングし、出力に基づいて情報を取得します。

インストール

前提条件

1. Blender: Blender 3.0以降。blender.orgからダウンロードしてください。
2. Ollama: OS 固有の指示に従って、 ollama.comからインストールします。
3. Python: Python 3.10 以降。
4. uv: pip install uvを使用してインストールします。
5. **Git:**リポジトリのクローンを作成するために必要です。

インストール手順

1. リポジトリをクローンします。
   git clone https://github.com/dhakalnirajan/blender-open-mcp.git cd blender-open-mcp
2. 仮想環境を作成してアクティブ化する（推奨）:
   uv venv source .venv/bin/activate # On Linux/macOS .venv\Scripts\activate # On Windows
3. 依存関係をインストールします:
   uv pip install -e .
4. Blenderアドオンをインストールします。
   • Blender を開きます。
   • Edit -> Preferences -> Add-onsに移動します。
   • Install...をクリックします。
   • blender-open-mcpディレクトリからaddon.pyファイルを選択します。
   • 「Blender MCP」アドオンを有効にします。
5. Ollama モデルをダウンロードします (まだインストールされていない場合)。
   ollama run llama3.2
   *( **Gemma3*などの他のモデルも使用可能です。)

設定

1. Ollama サーバーを起動します。Ollamaがバックグラウンドで実行されていることを確認します。
2. MCP サーバーを起動します。
   blender-mcp
   または、
   python src/blender_open_mcp/server.py
   デフォルトではhttp://0.0.0.0:8000をリッスンしますが、設定を変更できます。
   blender-mcp --host 127.0.0.1 --port 8001 --ollama-url http://localhost:11434 --ollama-model llama3.2
3. Blender アドオン サーバーを起動します。
   • Blender と 3D ビューポートを開きます。
   • サイドバーを開くにはNを押します。
   • 「Blender MCP」パネルを見つけます。
   • 「MCP サーバーを起動」をクリックします。

使用法

mcpコマンドライン ツールを使用してblender-open-mcpを操作します。

コマンド例

• 基本プロンプト:
  mcp prompt "Hello BlenderMCP!" --host http://localhost:8000
• シーン情報を取得:
  mcp tool get_scene_info --host http://localhost:8000
• キューブを作成する:
  mcp prompt "Create a cube named 'my_cube'." --host http://localhost:8000
• イメージをレンダリングする:
  mcp prompt "Render the image." --host http://localhost:8000
• PolyHaven の使用 (有効な場合):
  mcp prompt "Download a texture from PolyHaven." --host http://localhost:8000

利用可能なツール

トラブルシューティング

問題が発生した場合:

• Ollama とblender-open-mcpサーバーが実行されていることを確認します。
• Blenderのアドオン設定を確認してください。
• コマンドライン引数を確認します。
• エラーの詳細についてはログを参照してください。

さらにサポートが必要な場合は、 GitHub の問題ページをご覧ください。

AIとのブレンディングを楽しみましょう！🚀