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 サーバーを削除し、再度追加すると、準備完了です。
Related MCP server: FreeCAD MCP
特徴
双方向通信: ソケットベースのサーバーを介してClaude AIをBlenderに接続します
オブジェクト操作: Blender で 3D オブジェクトを作成、変更、削除する
マテリアルコントロール: マテリアルと色を適用および変更します
シーン検査:現在のBlenderシーンの詳細情報を取得します
コード実行: Claude の Blender で任意の Python コードを実行する
コンポーネント
このシステムは、次の 2 つの主要コンポーネントで構成されています。
Blenderアドオン（ ：Blender内にソケットサーバーを作成し、コマンドを受信して実行するBlenderアドオン
MCP サーバー ( : モデルコンテキストプロトコルを実装し、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アドオンのインストール
このリポジトリから
addon.pyファイルをダウンロードしますブレンダーを開く
編集 > 設定 > アドオンに移動します
「インストール...」をクリックし、
addon.pyファイルを選択します。「インターフェース: Blender MCP」の横にあるボックスにチェックを入れてアドオンを有効にします。
使用法
接続の開始
Blenderで、3Dビューサイドバーに移動します（表示されていない場合はNを押します）
「BlenderMCP」タブを見つけます
Poly HavenのAPIからアセットを取得する場合は、Poly Havenのチェックボックスをオンにします（オプション）
「クロードに接続」をクリック
ターミナルで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によって作成されました。