Blender MCP を Claude Code で使う：ステップバイステップ設定ガイド

結論

Claude Code で Blender MCP を使うには、uv をインストールし、claude mcp add blender uvx mcp-for-blender を実行し、uvx mcp-for-blender install-addon で Blender アドオンを入れ、Blender の設定で Interface: MCP for Blender を有効にしてから、/mcp で blender が接続済みになっていることを確認します。これで Claude が起動中の Blender でシーンを作成・編集できるようになります。

このサーバーは Siddharth Ahuja 氏によるコミュニティプロジェクトで、mcp.so では Blender MCP として掲載しています。以前は blender-mcp という名前でしたが、現在は PyPI で mcp-for-blender として公開されています。プロジェクトの README によると、uvx blender-mcp を使う既存の設定はそのまま動きますが、新規インストールでは新しい名前を使うべきです。Blender 公式の製品ではなく、サードパーティの連携ツールです。

Blender MCP の仕組み

構成要素は 2 つあり、両方が動いている必要があります。

1. MCP サーバー（mcp-for-blender）。Claude Code が stdio で自動的に起動します。自分でターミナルから実行する必要はありません。
2. Blender アドオン。Blender 内でソケットサーバー（デフォルトは localhost のポート 9876）を開き、コマンドを受け取って実行します。

Claude Code は MCP サーバーと通信し、MCP サーバーがそのソケット経由で各コマンドをアドオンに転送します。Blender が閉じている、またはアドオンが停止していると、MCP サーバーは起動してもツール呼び出しはすべて失敗します。

ツールの数は多くありません。主なものは execute_blender_code（起動中の Blender で Python を実行）、look（ビューポート、カメラ、多角度ビュー、レンダー結果を確認）、get_scene_info、search_assets と import_asset（Poly Haven、Sketchfab、Poly Pizza）、そして generate_3d（Tripo、Hunyuan3D、Hyper3D Rodin による AI モデル生成）です。モデリングの大半は Claude が Blender Python を書いて行い、look で自分の結果を確認します。

前提条件

まず uv をインストールします。README には、uv を入れる前に先へ進まないよう明記されています。

# macOS
brew install uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

インストール後は新しいターミナルを開き、uvx --version が動くことを確認します。

方法 A：ワンコマンドのインストーラー

プロジェクトには、マシン上の MCP クライアント（Claude Code を含む）を検出し、設定するクライアントを選ばせ、blender エントリを追加し、アドオンのインストールと有効化まで行うインストーラーがあります。

# macOS / Linux
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"

uv がすでにあるなら uvx mcp-for-blender setup でも同じです。既存の設定は保持され、変更したファイルごとに .bak が保存されます。パイプで実行するスクリプトは、不安なら先に中身を読みましょう。何が変わるかを正確に把握したい場合は、次の手動手順を使ってください。

方法 B：Claude Code で手動設定

ステップ 1：MCP サーバーを追加する

README に載っているコマンドです。

claude mcp add blender uvx mcp-for-blender

これはデフォルトの local スコープに保存されるため、現在のプロジェクトディレクトリでのみ使えます。Blender の作業は特定のリポジトリに縛られないことが多いので、たいていはどこでも使えるようにしたいはずです。その場合は user スコープを使います。

claude mcp add --scope user blender -- uvx mcp-for-blender

.mcp.json に書かれる project スコープのエントリは次のとおりです。

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["mcp-for-blender"]
    }
  }
}

スコープと承認の詳細は Claude Code MCP ガイドをご覧ください。

ステップ 2：Blender アドオンをインストールする

uvx mcp-for-blender install-addon

アドオンが blender_mcp.py として Blender のアドオンフォルダにコピーされ、書き込み先が表示されます。複数の Blender バージョンがある場合は、uvx mcp-for-blender addon-paths で検出されたフォルダを一覧できます。

続いて Blender で次の操作をします。

1. Edit → Preferences → Add-ons を開く。
2. "MCP for Blender" で検索し、Interface: MCP for Blender を有効にする。
3. 表示されない場合は Blender を再起動するか、Install… をクリックしてコピーされたファイルを選ぶ。

手動の代替手段：リポジトリから addon.py をダウンロードし、同じ Install… ボタンからインストールします。

ステップ 3：アドオンのサーバーを起動する

アドオンは Blender の起動時にサーバーを開始します。確認するには、3D ビューポートで N を押してサイドバーの MCP for Blender タブを開き、動いていなければ Start MCP Server をクリックします。同じパネルで Poly Haven などのオプションの素材ソースにもチェックを入れられます。

ステップ 4：Claude Code で確認する

ターミナルで実行します。

claude mcp list

次に claude を起動して /mcp を実行します。blender が接続済みと表示され、ツール一覧が出れば OK です。ただし接続済みの表示は、Claude Code が MCP サーバーを起動できたことしか意味しません。Blender 側まで通っているかは、小さな依頼で確かめます。

Use the blender MCP to get the scene info and list every object.

デフォルトのキューブ、カメラ、ライトが返ってくれば、すべてつながっています。

プロンプト例

小さく始めて、Claude に look ツールで結果を確認させましょう。

• 「金の壺を守るドラゴンがいる、ローポリのダンジョンシーンを作って。」
• 「この車を赤いメタリックにして、カメラビューを見せて。」
• 「Poly Haven の曇った午後の HDRI でシーンを照らし、壁に錆びた金属のテクスチャを貼って。」
• 「カメラをシーンに向けて、アイソメトリックにして。」
• 「Poly Pizza のローポリ家具でこの部屋を埋めて。それぞれ高さ約 1 メートルで。」
• 「現在のシーン情報を取得して、このリポジトリに three.js のスケッチを作って。」

最後の例こそ Claude Code がチャットアプリより優れている点です。同じセッションで Blender のシーンを読み取り、プロジェクトにコードを書けます。

オプション設定

以下はすべて README に記載されています。環境変数は --env で、サーバー名の後、-- の前に渡します。

claude mcp add blender --env BLENDER_MCP_SAFE_MODE=1 -- uvx mcp-for-blender

2 つの Blender インスタンスを操作するには、--port 9877 を付けた 2 つ目のサーバーを追加し、2 つ目の Blender のアドオンパネルで同じポートを設定します。

Sketchfab、Poly Pizza、Hyper3D、Hunyuan3D の API キーは Edit → Preferences → Add-ons → MCP for Blender に保存でき、再起動後も保持されます。

トラブルシューティング

conda、pyenv、asdf のせいで uv が問題のあるインタープリターを選んでしまう場合は、README の推奨どおり Python を固定します。

claude mcp add blender --env UV_PYTHON_PREFERENCE=only-managed \
  -- uvx --python 3.11 mcp-for-blender

失敗した状態が繰り返し再現する場合は、uv cache clean mcp-for-blender blender-mcp でキャッシュを消します。

また、アドオンに接続するクライアントは同時にひとつだけにしてください。Claude Desktop や Cursor にも同じサーバーを設定しているなら、Claude Code を使う間は閉じておきます。

安全に使うために

execute_blender_code は Blender 内で任意の Python を実行し、アドオンのソケットには認証がありません。次の 3 つの習慣が役立ちます。

• セッションの前に .blend ファイルを保存する。 README も太字で強調しており、そのとおりです。
• ソケットは localhost に限定する。 リモートで使うなら、BLENDER_HOST をリモートマシンに向けるのではなく SSH トンネルを使います。
• セーフモードを有効にする。 スクリプトにファイルやネットワークへのアクセスが不要な場合に有効です。

ワークフローを信頼できるようになるまで、execute_blender_code に対する Claude Code のツール承認はオンのままにしておきましょう。一般的な考え方は MCP セキュリティのベストプラクティスにまとめています。

次のステップ

Blender MCP は、three.js の書き出し結果を確認するための Playwright MCP のようなブラウザ系サーバーや、デザインから 3D 制作を始める場合の Figma MCP と相性が良いです。ほかのクリエイティブ・開発ツールは MCP サーバーディレクトリで探せます。プロトコル自体が初めてなら、MCP サーバーとはから読んでみてください。