BlenderMCP - Blender モデルコンテキストプロトコル統合

BlenderMCPは、Model Context Protocol（MCP）を介してBlenderをClaude AIに接続し、ClaudeがBlenderを直接操作できるようにします。この統合により、迅速な3Dモデリング、シーン作成、操作が可能になります。

完全なチュートリアル

コミュニティに参加する

フィードバックを提供し、インスピレーションを得て、MCP: Discordをベースに構築しましょう

サポーター

トップサポーター:

コードラビット

すべてのサポーター:

このプロジェクトを支援する

リリースノート（1.1.0）

• Poly Haven アセットの API 経由でのサポートを追加しました
• Hyper3D Rodin を使用した 3D モデルのサポートを追加しました
• 初めての方は、すぐにインストールに進んでください。既存の方は、以下の点をご確認ください。
• 最新のaddon.pyファイルをダウンロードし、古いファイルを置き換えてBlenderに追加します。
• Claude から MCP サーバーを削除し、再度追加すると、準備完了です。

特徴

• 双方向通信: ソケットベースのサーバーを介してClaude AIをBlenderに接続します
• オブジェクト操作: Blender で 3D オブジェクトを作成、変更、削除する
• マテリアルコントロール: マテリアルと色を適用および変更します
• シーン検査:現在のBlenderシーンの詳細情報を取得します
• コード実行: Claude の Blender で任意の Python コードを実行する

コンポーネント

このシステムは、次の 2 つの主要コンポーネントで構成されています。

1. Blenderアドオン（ addon.py ） ：Blender内にソケットサーバーを作成し、コマンドを受信して実行するBlenderアドオン
2. MCP サーバー ( src/blender_mcp/server.py ) : モデルコンテキストプロトコルを実装し、Blender アドオンに接続する Python サーバー

インストール

前提条件

• Blender 3.0以降
• Python 3.10以降
• uv パッケージマネージャー:

Macをお使いの場合は、uvをインストールしてください。

Windowsの場合

その後

それ以外の場合、インストール手順はウェブサイトに掲載されています: Install uv

⚠️UVをインストールする前に続行しないでください

デスクトップ統合のクロード

セットアップ手順のビデオを見る（すでにuvがインストールされていることを前提としています）

Claude > 設定 > 開発者 > 構成の編集 > claude_desktop_config.json に移動して、以下を追加します。

カーソル統合

Macユーザーの場合は、「設定」>「MCP」に移動し、次のコードを貼り付けます。

• グローバルサーバーとして使用するには、「新しいグローバルMCPサーバーを追加」ボタンを使用して貼り付けます。
• プロジェクト固有のサーバーとして使用するには、プロジェクトのルートに.cursor/mcp.jsonを作成し、貼り付けます。

Windows ユーザーの場合は、[設定] > [MCP] > [サーバーの追加] に移動し、次の設定で新しいサーバーを追加します。

カーソル設定ビデオ

⚠️ MCP サーバーのインスタンスを 1 つだけ実行します (Cursor または Claude Desktop のいずれか)。両方実行しないでください。

Blenderアドオンのインストール

1. このリポジトリからaddon.pyファイルをダウンロードします
2. ブレンダーを開く
3. 編集 > 設定 > アドオンに移動します
4. 「インストール...」をクリックし、 addon.pyファイルを選択します。
5. 「インターフェース: Blender MCP」の横にあるボックスにチェックを入れてアドオンを有効にします。

使用法

接続の開始

1. Blenderで、3Dビューサイドバーに移動します（表示されていない場合はNを押します）
2. 「BlenderMCP」タブを見つけます
3. Poly HavenのAPIからアセットを取得する場合は、Poly Havenのチェックボックスをオンにします（オプション）
4. 「クロードに接続」をクリック
5. ターミナルでMCPサーバーが実行中であることを確認してください

クロードと一緒に使う

Claude で設定ファイルが設定され、アドオンが Blender で実行されると、Blender MCP のツールが付いたハンマー アイコンが表示されます。

機能

• シーンとオブジェクトの情報を取得する
• 図形の作成、削除、変更
• オブジェクトにマテリアルを適用または作成する
• Blenderで任意のPythonコードを実行する
• Poly Havenから適切なモデル、アセット、HDRIをダウンロード
• Hyper3D Rodinによる AI 生成 3D モデル

コマンド例

クロードに依頼できる作業の例をいくつか示します。

• 「ドラゴンが金の壺を守っているダンジョンのローポリシーンを作成する」デモ
• 「Poly HavenのHDRI、テクスチャ、岩や植物などのモデルを使用してビーチの雰囲気を作りましょう」デモ
• 参照画像を提供し、それを基に Blender シーンを作成するデモ
• 「Hyper3D でガーデンノームの 3D モデルを生成する」
• 「現在のシーンの情報を取得し、そこからthreejsスケッチを作成する」デモ
• 「この車を赤くメタリックにしてください」
• 「球体を作成し、立方体の上に配置します」
• 「照明をスタジオのようにする」
• 「カメラをシーンに向け、等角投影にする」

Hyper3D統合

Hyper3Dの無料トライアルキーでは、1日に生成できるモデルの数に制限があります。1日の制限数に達した場合は、翌日のリセットを待つか、hyper3d.aiおよびfal.aiから独自のキーを取得してください。

トラブルシューティング

• 接続の問題：Blenderアドオンサーバーが起動していること、およびClaudeでMCPサーバーが設定されていることを確認してください。ターミナルでuvxコマンドを実行しないでください。最初のコマンドが通らない場合もありますが、その後は正常に動作するようになります。
• タイムアウトエラー: リクエストを簡素化するか、小さなステップに分割してみてください
• Poly Haven 統合: Claude の動作が不安定になることがある
• 電源をオフにして再度オンにしてみましたか？ : それでも接続エラーが発生する場合は、ClaudeとBlenderサーバーの両方を再起動してみてください。

技術的な詳細

通信プロトコル

システムは TCP ソケット上でシンプルな JSON ベースのプロトコルを使用します。

• コマンドは、 typeとオプションのparamsを持つJSONオブジェクトとして送信されます。
• レスポンスはstatusとresultまたはmessageを持つJSONオブジェクトです

制限事項とセキュリティに関する考慮事項

• execute_blender_codeツールは、Blender内で任意のPythonコードを実行できます。これは強力なツールですが、潜在的に危険な可能性があります。本番環境では慎重に使用してください。使用する前に必ず作業内容を保存してください。
• Poly Havenを使用するには、モデル、テクスチャ、HDRI画像のダウンロードが必要です。使用しない場合は、Blenderのチェックボックスをオフにしてください。
• 複雑な操作は小さなステップに分割する必要があるかもしれない

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

免責事項

これはサードパーティの統合であり、Blenderによって作成されたものではありません。Siddharthによって作成されました。