mcp-for-blender

MCP for Blender は、Model Context Protocol (MCP) を通じて Blender 3D を任意の LLM（Claude、Codex、Cursor など）に接続するコミュニティ製プラグインです。自然言語のプロンプトを使って 3D シーンの作成、変更、操作ができます。 ## 主な機能 - **双方向通信**: ソケットベースのサーバーを介してAIアシスタントをBlenderに接続 - **オブジェクト操作**: 3Dオブジェクトの作成、変更、削除 - **マテリアル制御**: マテリアルと色の適用および変更 - **コード実行**: AIからBlender内で任意のPythonコードを実行 - **アセット＆モデル生成**: Poly Haven、Sketchfab、Poly Pizzaからのインポート、およびHyper3D RodinとHunyuan3DによるAI生成モデルのインポート ## 仕組み プラグインは主に2つの部分で構成されています。 1. **MCPサーバー** (`src/blender_mcp/server.py`) - Model Context Protocolを実装したPythonサーバー 2. **Blenderアドオン** - Blenderの3Dビューポートにあるサイドバーパネルで、接続を開始します ## セットアップ 1. 公式インストーラーを使用して `uv`（Pythonパッケージマネージャー）をインストールします 2. Blenderアドオンをインストールします（コマンドラインまたはBlenderの設定から手動で） 3. MCPクライアント（Claude Desktop、Claude Code、Codex、Cursor、VS Code など）を設定します 4. Blenderで `N` キーを押してサイドバーを開き、**MCP for Blender** タブを見つけて **Start MCP Server** をクリックします ## 可能な操作 - Blender内で任意のPythonコードを実行 - Poly Havenからモデル、アセット、HDRIをダウンロード - Sketchfabからモデルを検索・ダウンロード - Poly Pizzaからローポリモデルを検索・ダウンロード - Hyper3D RodinとHunyuan3D（Tencent Cloud）で3Dモデルを生成 ## コマンド例 - 「ダンジョンのローポリシーンを作成し、金の壺を守るドラゴンを配置して」 - 「参考画像を渡すので、それからBlenderシーンを作成して」 - 「Hyper3Dでガーデンノームの3Dモデルを生成して」 - 「この部屋をPoly Pizzaのローポリ家具で埋めて」 ## 設定 環境変数によるカスタマイズが可能です： - `BLENDER_HOST`（デフォルト: `localhost`） - `BLENDER_PORT`（デフォルト: `9876`） - `BLENDER_MCP_SAFE_MODE` - 実行前にスクリプトを検証するには `1` に設定 ## セキュリティに関する考慮事項 - アドオンのソケットサーバーには認証や暗号化がありません - デフォルトでは、AIはBlender内で任意のPythonコードを実行できます - セーフモード（`BLENDER_MCP_SAFE_MODE=1`）では、ファイルI/O、ネットワークアクセス、永続的なコードインストールなどの危険な操作をブロックします ## 永続的なAPI認証情報 Sketchfab、Poly Pizza、Hyper3D、Hunyuan3DのAPIキーは、Blenderの設定に保存するか、ヘッドレス/CI環境では環境変数で指定します。 ## Dockerサポート MCPサーバーはローカルにインストールする代わりにコンテナ内で実行できます。Blenderは引き続きお使いのマシンで動作し、コンテナはMCPサーバーをホストしてBlenderアドオンに接続するだけです。 ## 免責事項 これはサードパーティ製の統合であり、Blenderによるものではありません。