blender-ai-mcp-addon — Blender操作とMCP連携を実現するAI拡張機能
hitkeeen/blender-ai-mcp-addon
★ 1,167 ・ MIT
概要
blender-ai-mcp-addon(README内では「mcp-for-blender-pro」と表記)は、オープンソースの3DCG制作ソフトウェア「Blender」にAIアシスタント機能とModel Context Protocol(MCP)サーバーを統合するためのアドオン(拡張機能)です。
自然言語による指示を通じてBlender内のシーン構造を把握し、オブジェクトの生成・配置、マテリアルの変更、外部アセットの検索や配置、複数ステップからなるワークフローの実行などを支援します。素早いイテレーションを行いたい3Dアーティスト、定型作業を自動化したいテクニカルアーティスト、あるいはBlenderを自作のAIワークフローや外部ツールと連携させたい開発者に向いているツールです。
主な特徴
- Blenderのコンテキストを把握したアシスト シーンやオブジェクトの構造を事前に検査・取得した上でLLMが動作するため、現在の制作状況に即した操作指示や提案が行われます。
- Studioワークスペース Blenderのメイン画面とは別に、チャット履歴、シーン内のオブジェクト一覧、ビューポートのスナップショット、操作の承認フロー、タスクボードなどを備えたコンパニオンウィンドウ(Studio)を利用できます。
- 多様なモデル接続 OpenAI(ChatGPT)、Anthropic Claude、Google Gemini、OpenRouter、OpenCode Zenなどのクラウドサービスに加え、ローカルで動作するOllamaや互換カスタムエンドポイントの利用に対応しています。
- 単一アシスタントとチームチェーン構成 シンプルな修正には単一のモデルを利用し、大規模なタスクにはマネージャー、ワーカー、レビュアーといった役割分担を定義した「Team chain」によるマルチエージェント実行が可能です。
- 内蔵MCPサーバー 認証付きStreamable HTTP MCPに対応したMCPサーバーが組み込まれており、OpenCodeなどの対応外部クライアントからBlenderのシーンツールを呼び出せます。
- 21種類のシーン操作ツール 基本プリミティブの生成、オブジェクトの移動や複製、マテリアル割り当て、ビューポートのスクリーンショット取得、Pythonスクリプト実行、API参照など、Blender操作に特化したツールが用意されています。
使い方
READMEに記載されているセットアップ手順は次のとおりです。
1. インストール手順
- リポジトリのReleasesページから
mcp-for-blender-pro.zipをダウンロードします。 - Blenderを起動し、メニューの 編集 (Edit) → プリファレンス (Preferences) → Get Extensions → メニュー → ディスクからインストール (Install from Disk) を選択します。
- ダウンロードしたZIPファイルを選択してアドオンを有効化します。
- 3Dビューポートのサイドバー(Nキー)から MCP Pro タブを開きます。
- 利用したいプロバイダーを選択し、接続情報(APIキーなど)を設定してモデルを選択します。
- Blenderのサイドバー上でメッセージを送信するか、Open Studio Window をクリックしてStudioワークスペースを開きます。
※外部クライアントやStudioを使用する間は、Blenderを起動したままにしておく必要があります。
2. プロンプト例
READMEには、以下のような指示文の例が挙げられています。
# シーン構造の確認
Inspect this scene and explain its object structure before making any changes.
# スタジオセットの作成
Create a simple product-display scene with a pedestal, a camera and three lights. Give the pedestal a matte blue material.
# オブジェクトの複製と配置
Duplicate the selected object into a neatly spaced row of five and show the viewport.
# 外部アセットの検索と配置の確認
Find an appropriate Poly Haven asset for this scene and ask before importing it.
技術的なポイント
- Model Context Protocol(MCP)への準拠 Blender自身をMCPサーバーとして動作させることで、LLM側から標準化されたインターフェース経由でBlenderの内部関数を実行できます。認証付きのStreamable HTTP MCPをサポートしており、OpenCodeなどのMCPクライアントとの接続が容易です。
- 21種類のツール分類
ツール群は「シーン検査(
get_scene_info,list_objects,get_object_info)」「オブジェクト生成(add_cube,add_sphere,add_light,add_camera等)」「編集(move_object,duplicate_object,delete_object,set_material等)」「視覚フィードバックとスクリプト(viewport_screenshot,execute_code)」「Blender API・エクスポート(bpy_api_lookup,describe_node_type,export_scene)」「アセット操作(search_assets,import_asset)」に整理されています。 - マルチモーダルとビューポート連携
画像認識に対応したモデルを使用する場合、
viewport_screenshotツールでキャプチャしたビューポート画像を参照させながら作業を進めることが可能です。 - タスク実行とレビューの仕組み マルチエージェント機能(Team chain)では、マネージャーが課題を分解して作業基準を設定し、ワーカーが操作を実行、レビュアーが結果を検査します。シーンの不整合を防ぐためタスクは順次(シーケンシャル)に実行され、タスクが停滞した場合は1回まで修正試行が行われます。2回連続でレビューに失敗した場合は安全のためにワークフロー全体が停止します。
- 外部アセットプラットフォームとの統合 Poly Haven、Sketchfab、Poly Pizzaの検索およびインポート機能が備わっています(一部サービスではAPIキー設定が必要)。
注意点
- 対応環境 配布されているリリースバンドルは、Blender 4.2以降、プラットフォームは Windows x64 を対象としています。他のOS環境における動作可否や制限についてはREADMEに明記されていません。
- セキュリティ上の注意 Pythonコードを実行するツールには許可されない操作を検出するバリデーションが含まれていますが、READMEには「完全なセキュリティサンドボックスではない(not a security sandbox)」と明記されています。信頼できないプロンプトやモデル出力の実行には注意が必要です。
- 履歴と認証情報の扱い APIキーなどの接続情報はユーザー設定内に保存されます。チャット履歴は現在のセッション中のみ保持され、Blenderを終了するとリセットされます。
- アセット利用時のライセンス 外部サービスからインポートした3Dアセットを使用する場合は、各アセットに設定されているライセンス条件を個別に確認して遵守する必要があります。
- 独立プロジェクト 本プロジェクトはオープンソース(MITライセンス)として公開されており、Blender Foundationや記載されている各AIサービス提供元との公式な提携・推奨関係はありません。
まとめ
blender-ai-mcp-addon は、Blender環境にMCPサーバーと専用UIを統合し、自然言語による3Dシーン操作やマルチエージェントによるタスク実行を実現する拡張機能です。多様なLLM接続やローカルモデルに対応しており、Blenderを用いた3D制作プロセスの自動化やワークフロー改善に関心がある方にとって有用なツールといえます。





