blender-ai-mcp-addon — Blender上でAI操作やMCP連携を行えるアドオン
bookwjitchieni1986/blender-ai-mcp-addon
★ 1,795 ・ MIT
概要
blender-ai-mcp-addon(README内表記:mcp-for-blender-pro)は、3DCGソフトウェア「Blender」上で動作するAIアシスタント機能と、Model Context Protocol(MCP)サーバーを提供する拡張機能です。Blenderのシーン内にあるオブジェクトの構造を把握したうえで、オブジェクトの追加、マテリアル設定、アセットの検索や配置、シーンのエクスポートといった一連の操作を自然言語の対話を通して実行させることができます。
本アドオンは、制作工程の試行錯誤を迅速化したい3Dアーティストをはじめ、定形作業の自動化を目的とするテクニカルアーティストや、MCPを活用して外部のAIツールとBlenderを連携させたい開発者に向けて設計されています。Blender内部のチャットや別ウィンドウの作業空間(Studio)からモデルへ指示を出し、ビューポートプレビューで結果を確認しながら制作を進められます。
主な特徴
- シーンコンテキストの把握と21種類の専用ツール: オブジェクト情報やシーン構造を事前に把握した上で、形状作成、ライト・カメラ配置、マテリアル編集、ビューポート撮影、スクリプト実行などの操作ツールを自律的に呼び出します。
- Studioワークスペースによる視覚的な支援: チャット欄、シーン内オブジェクトの一覧、ビューポートのスナップショット、操作の承認、タスクボードなどを備えた別ウィンドウ環境が提供されます。
- 多様なAIプロバイダーとローカルモデルへの対応: OpenAI、Anthropic Claude、Google Gemini、OpenRouter、OpenCode Zenのほか、Ollamaを用いたローカルモデルやカスタムエンドポイントにも接続可能です。
- 単体アシスタントとチーム連携(マルチエージェント)の切り替え: 直接対話しながら作業するモードに加え、マネージャー・作業者・レビュアーの3役でタスクの分割から実行、確認までを順序立てて行う「Team chain」ワークフローを備えています。
- MCP(Model Context Protocol)サーバーの内蔵: 認証付きのStreamable HTTP MCPをサポートしており、OpenCodeなどのMCPクライアントからローカルエンドポイント経由でBlenderを操作できます。
- 外部アセットプラットフォームとの連携: Poly Haven、Sketchfab、Poly Pizzaに対応しており、プロンプト経由で素材を検索し、確認を経てシーン内に取り込むことが可能です。
使い方
インストール手順
READMEに記載されている導入手順は次のとおりです。配布パッケージはBlender 4.2以降のWindows x64環境を対象としています。
- リリースページから
mcp-for-blender-pro.zipをダウンロードします。 - Blenderを起動し、Edit → Preferences → Get Extensions → メニュー → Install from Disk の順に開きます。
- ダウンロードしたZIPファイルを選択してアドオンを有効化した後、3D Viewport → Nキー(サイドバー) → MCP Pro を開きます。
- プロバイダーを選択して接続情報(APIキー等)を入力し、使用するモデルを指定します。
- Blender内のチャットにメッセージを入力するか、Open Studio Window をクリックしてStudio画面を起動します。
外部クライアントやStudioを使用する間は、Blenderを起動したままにしておく必要があります。
プロンプトの例
READMEでは、以下のような指示文の例が挙げられています。
- 「変更を加える前に、このシーンを調査してオブジェクト構造を説明してください」
- 「台座、カメラ、3つのライトで構成されるシンプルな商品展示シーンを作成してください。台座にはマットな青色のマテリアルを設定してください」
- 「選択したオブジェクトを等間隔に5個複製して横一列に並べ、ビューポートを表示してください」
- 「このシーンに適したPoly Havenのアセットを探し、インポートする前に確認してください」
技術的なポイント
MCPサーバーとしての機能と提供ツール
本アドオンはModel Context Protocolのサーバーとして機能するため、Blender外のMCP対応クライアント(OpenCodeなど)から標準的なプロトコル経由でシーン操作を呼び出せます。用意されている21種類のツールは目的ごとに分類されています。
- シーン調査:
get_scene_info、list_objects、get_object_info - オブジェクト生成:
add_cube、add_sphere、add_cylinder、add_plane、add_light、add_camera - 編集・操作:
move_object、duplicate_object、delete_object、parent_objects、set_material - 視覚フィードバックおよびスクリプト実行:
viewport_screenshot、execute_code - Blender API参照およびエクスポート:
bpy_api_lookup、describe_node_type、export_scene - アセット連携:
search_assets、import_asset
これらのツール群により、AIは単にPythonスクリプトを実行するだけでなく、あらかじめ定義されたAPIを通じて安全かつ構造的にBlenderのシーンを更新します。
マルチエージェントによるレビュー体制
「Team chain」機能では、大規模な作業を以下の3つの役割に分割して処理します。
- Manager(マネージャー): ユーザーからの要求を個別の割り当てと合格基準(受入条件)に分解します。
- Workers(作業者): 割り当てられたシーン操作を実行します。
- Reviewers(レビュアー): 実行結果を検証し、承認するか具体的な修正点を返却します。
シーンの不整合を防ぐため、タスクは逐次的に実行されます。差し戻されたタスクには1回の修正試行が与えられ、2回目のレビューでも不合格となった場合はワークフローが停止します。タスクボード上では、割り当て状況や試行回数、指摘内容が可視化されます。
接続管理と安全管理
カスタムエンドポイントとしては、OpenAI Chat Completions、Anthropic Messages、Ollamaプロトコルが利用可能です。画像入力に対応したモデルであれば、ビューポートのスクリーンショットを参照して状況を判断できます。
シーンの意図しない改変を防ぐため、組み込みチャットでは操作前の承認機能やステップごとのキャンセル、名前付きアンドゥ(取り消し)ステップをサポートしています。また、Pythonツールのバリデーション機能により許可されていない操作を検出する仕組みも用意されています(ただし、セキュリティサンドボックスではない旨が明記されています)。認証情報はユーザー設定に保存され、チャット履歴は現在のセッション中のみ保持されます。
注意点
- 対応環境: 配布されているリリースバンドルは、Blender 4.2以降のWindows x64環境を前提としています。他のOS環境における動作可否はREADMEから確認できません。
- セキュリティの境界: Pythonツールの検証機構は不正な処理を抑止するための補助的なものであり、厳密なサンドボックス環境ではありません。信頼できないプロンプトやモデル出力の取り扱いには注意が必要です。
- ライセンスと外部規約: 本アドオン自体はMITライセンスで公開されていますが、バンドルされているOpenCodeには個別のライセンスが適用されます。また、Poly HavenやSketchfabなどの外部素材を利用する際は、各アセットのライセンス規約および各AIプロバイダーのAPI利用規約を遵守する必要があります。
まとめ
blender-ai-mcp-addonは、BlenderとLLMをMCPプロトコルや専用ツール群を介して接続する拡張機能です。単一の対話モデルによる簡単なシーン操作から、マルチエージェントによる検証を伴うワークフローまで幅広く対応しています。Blenderを用いた3D制作環境において、AIを活用した効率的な作業環境を構築したい場合の実用的な選択肢となります。





