blender-mcp-integration

Blender MCP 統合

自律的な判断、エビデンスの提示頻度、長時間タスクの継続性について、タスクごとに一度、 共通の実行ガイダンスを読んでください。

タスクの改善に役立つ、最も範囲の狭い MCP レイヤーを使用してください。

レイヤーを選択する

ライブビューポートが必要なタスクでは、接続済みの Blender セッションがあるか確認してください。 利用できるセッションがない場合は、Blender を起動するか提案し、ユーザーが現在の会話ですでに起動を許可している場合を除き、 起動前にユーザーに確認してください。許可を得たら、要求されたアセットを使って別のセッションを開き、 Agent Studio Live に接続してから、blender_open_viewport を再試行してください。 既存の Blender セッションと未保存の作業は保持してください。接続がない場合はセットアップの手順が必要なだけであり、 ビューポートへの引き渡しを断念する理由にはなりません。

インラインビューポートには、バンドルされている Agent Studio Live アドオンと blender_open_viewport を使用してください。更新、軸／オービット／ズームによるナビゲーション、 およびサーフェスやオブジェクトリストの項目をクリックして、ユーザーの次のメッセージに正確なシーンコンテキストを付加する機能に対応しています。 Blender でプラグインのルートにある addon/blender_agent_studio_live.py をインストールして有効にし、 3D ビューポートのサイドバーで Connect Agent Studio を押してください。 インタラクティブな Blender セッションと GPU コンテキストが必要です。 通常のファイルツールは、これとは独立して動作します。 詳しくはライブビューポートガイドを参照してください。 このブリッジは、任意の Python を実行したり、ジオメトリを変更したりしません。 一般的なライブ編集には、以下で説明する別の統合も使用できます。

1. 通常のスクリプトによる構築、検査、レンダリングには、バンドルされているツールと Blender CLI を使用してください。対応バージョンの Blender を開いたセッションでライブ操作が必要な場合に限り、Blender 公式の Lab MCP を追加してください。
2. 決定論的なバッチ検査、標準化されたジオメトリエビデンス、範囲を限定した作成済みシーンのレンダリングには、Blender Agent Studio の MCP を使用してください。blender_render_scene はカメラ、ライト、ボリューム、カラー管理を維持し、最初の画像をインラインで返します。inspectOnly はレンダリング前にシーン設定を検出します。バンドルされている Poly Haven の検索／ダウンロードツールを使えば、追加のアドオンや API キーなしで、検証済みの CC0 テクスチャと HDRI も取得できます。マテリアルの設定とスタンドアロン CLI の使用については、レンダリングワークフローを参照してください。
3. 追加のリモートホスト、Poly Haven、Sketchfab、外部 3D 生成との統合が必要で、インストール、ネットワーク、認証情報、テレメトリーの対象範囲が広がることを許容できる場合に限り、ahujasid/blender-mcp を検討してください。
4. 同じホスト／ポートで複数のアドオンソケットサーバーを実行しないでください。

Blender アドオンをインストールまたは置き換える前に、 references/mcp-options.mdを読んでください。

Mixamo ブラウザー統合

blender_prepare_mixamo_search は、ブラウザー検索 URL とワークフローを返します。カタログの検索結果は返しません。 ライブ検索、プレビュー、ダウンロードにはホストのブラウザーツールを使用し、 新しい単独のアニメーション付き .blend を作成するには blender_import_mixamo_animation を使用してください。 Adobe へのサインインはブラウザー内で行ってください。 ダウンロード設定、ローカルインポート、リターゲットの制限については、アニメーションワークフローの Mixamo ガイドを参照してください。

Pixabay 効果音ブラウザー統合

blender_prepare_pixabay_sound_search は、効果音の検索 URL とブラウザーワークフローを返します。ライブのカタログ結果は返しません。 ホストのブラウザーツールを使用して検索結果を確認し、候補をプレビューして、選んだ音声をダウンロードしてください。 ローカルの音声ファイルの横に、タイトル、クリエイター、再生時間、ソースページを記録してください。 用途に応じて、現在のPixabay コンテンツライセンスを確認してください。 音声を単独のアセットとして再配布しないでください。 Pixabay の公開されている APIは画像と動画を対象としているため、 このツールは音声 API を使用せず、カタログのスクレイピングも行いません。 Blender のシーンに音声をインポートする機能はありません。

オプションのシーン分析ランタイム

カメラを一致させた参照画像／シルエット／オーバーレイのボードには、blender_compare_reference を使用します。Rust を介さずに Blender で直接動作し、画像をインラインで返します。レビュー済みの白地に黒のマスクを指定すると投影メトリクスを有効にできますが、写真だけの場合は視覚的な比較のみとなり、推測による類似度スコアは生成されません。ジオメトリを比較する前に、bpy またはライブ MCP を使って参照カメラを作成してください。

blender_describe_scene、blender_quality_report、blender_compare_scenes は、同梱の Rust SceneIR アナライザーを使用します。安定版の Rust ツールチェーンを使用して、インストール済みプラグインのルートで bun run setup:runtime を実行するか、互換性のあるビルド済みバイナリを BAS_RUNTIME_EXECUTABLE に設定してください。アップデート後は再ビルドしてください。既存のツールは Rust に依存せず、引き続き使用できます。

まず簡潔なシーン説明を取得し、その後、正確な objectId とその子孫を照会します。境界ボックスには評価済みのワールドジオメトリが使用されます。セマンティックロールは、作成時に設定された bas_role プロパティにのみ基づきます。品質制約はブリーフに基づいて指定してください。接地チェックには、名前付きオブジェクトと groundZ が必要です。AABB の関係は候補であり、正確なメッシュ交差ではありません。返された制限事項と必要な視覚的確認事項を、検出結果とともに保持してください。数値化された美観スコアは生成されません。

ソースレベルの修正後は、blender_compare_scenes を使って、保持したアセットと再生成したアセットを比較します。事実に基づく変更と、明示的に宣言された不変条件の失敗を分け、同一の視覚的証拠と組み合わせてください。保持条件から編集済みのコンポーネントを除外する場合は、invariantObjects を使用します。

再現性を維持する

• ライブ MCP 実行を使う場合も、永続的なモデルは Python ソースファイルに保持します。
• リスクの高い任意コード操作の前に、新しい .blend を保存します。
• インタラクティブな反復には、公式の MCP スクリーンショットを使用します。
• 最終的なクリーンプロセスでの確認と固定の証拠カメラには、$blender-agent-studio:blender-asset-validation を使用します。
• ベンチマーク実行で使用した MCP ツールを記録します。

MCP の価値をベンチマークする

次を比較します。

1. MCP ツールを利用できない状態でのプラグインスキル。
2. 候補の MCP を有効にした状態での同じスキル。

タスク、モデル、労力、時間制限、評価者を同一にします。実行失敗、復旧に要したターン数、時間、最終的なアセット品質を記録します。成果を改善するか、確実に完了するためのコストを大幅に削減する場合にのみ、MCP への依存を維持してください。