Blender MCP とは
MCP(Model Context Protocol)は、エージェントに別のプログラムを操作するツールを与えます。2つの Blender MCP プロジェクトは、どちらも同じ2つの部分でできています。Blender の中で小さなサーバーを動かすアドオンと、エージェントが起動し、ツール呼び出しを TCP ソケット越しの JSON としてアドオンに転送する MCP サーバーです。
多くの人が指すのは mcp-for-blender です。README の冒頭には、サードパーティの連携であり Blender が作ったものではないという注意書きがあります。ライセンスは MIT で、2026年11月21日時点の GitHub スターは 35,153。PyPI のパッケージ名は blender-mcp から mcp-for-blender に変わりました(11月18日にバージョン 2.3.1)。uvx blender-mcp でもサーバーは起動するので、古い設定もそのまま動きます。
Blender Lab の blender_mcp が公式のものです。readme では、意図的に小さく作った軽量サーバーで、Blender の Python API への自然言語インターフェース、ドキュメントへのアクセス向上、複雑なシーンの調査が狙いだと説明されています。Claude のコネクタディレクトリにも、Blender Lab 提供の Blender として Anthropic 認証済みで掲載されています。
mcp-for-blender と Blender Lab の blender_mcp
2026年11月21日時点の GitHub と projects.blender.org のリポジトリの数値です。
| mcp-for-blender(コミュニティ) | blender_mcp(Blender Lab) | |
|---|---|---|
| 作者 | Siddharth Ahuja。Blender Foundation とは無関係 | Blender Lab(Blender プロジェクトの一部) |
| ライセンス | MIT | GPL-3.0 |
| Blender のバージョン | 3.0 以降 | 5.1 以降 |
| スター | GitHub で 35,153 | projects.blender.org で 39 |
| ツール | 9つ。execute_blender_code、look(ビューポートとカメラの視点)、get_scene_info、アセットの検索とインポート(Poly Haven、Sketchfab、Poly Pizza)、generate_3d(Tripo、Hunyuan3D、Hyper3D Rodin、Meshy)を含む | execute_blender_code、execute_blender_code_for_cli(バックグラウンドの Blender)、blend ファイルとオブジェクトの要約、get_python_api_docs、スクリーンショット。Python API とマニュアルの抜粋を同梱 |
| 導入 | ワンコマンドのインストーラーか uvx mcp-for-blender。Claude Code、Codex、Cursor などの設定を内蔵 | リポジトリを git clone して uv で実行し、Blender にアドオンを追加 |
| 向いている用途 | シーンの構築と飾りつけ、アセットの取り込み、モデルの生成 | ファイルの確認と Blender の API についての質問(最新の Blender 向け) |
クイックインストール:すべてのエージェントを一度に
mcp-for-blender の README が勧める方法は、コマンド1つです。必要なら uv をインストールし、マシン上の MCP クライアント(Claude Desktop、Claude Code、Codex、Cursor、VS Code、Windsurf、OpenCode、Antigravity)を探し、設定するものを選ばせ、そのあと Blender アドオンをインストールして有効にします。各設定ファイルには blender のエントリを追加するだけで、変更したファイルはすべて .bak を残します。終わったら、エージェントを完全に終了してから開き直してください。
以下のコマンドは README からそのまま写したもので、実行はしていません。スクリプトをシェルにパイプすると、あなたの権限で実行されます。1ステップずつ確認したいなら、次の2つのセクションの手動セットアップを使ってください。
- macOS / Linux:
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh - Windows(PowerShell):
irm https://www.mcp-for-blender.com/install.ps1 | iex - uv をすでに入れている場合:
uvx mcp-for-blender setup - Blender 3.0 以降、Python 3.10 以降、uv が必要です。
Claude Code に Blender MCP を導入する
mcp-for-blender の手動セットアップです。コマンドはプロジェクトの README と Claude Code の MCP ドキュメントから写したもので、実行はしていません。
uv をインストールする
uv は、サーバーを起動する
uvxコマンドを提供します。README はpip install uvを避けるよう警告しています。公式のインストーラーを使ってください。# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows winget install --id=astral-sh.uv -eサーバーを登録する
現在のプロジェクト用にサーバーを保存します。どこでも使うには
--scope userを付けます。こうしたオプションは、サーバーのコマンドと区切る--の前に置きます。これは Claude Code のドキュメントが使っている形です。セッションの中では、/mcpで同じ状態を確認できます。# README のコマンド claude mcp add blender uvx mcp-for-blender # 確認:サーバーが connected と表示されるはず claude mcp list claude mcp get blender任意:テレメトリをオフにする
README によると、サーバーの環境に
DISABLE_TELEMETRY=trueを設定すると、テレメトリは完全にオフになります。Claude Code のclaude mcp addは環境変数を--envで受け取ります。正確な書き方は Claude Code の MCP ドキュメントを見てください。Blender アドオンをインストールして有効にする
そのあと Blender で Edit → Preferences → Add-ons を開き、"Interface: MCP for Blender" を有効にします。3D ビューポートで N キーを押して MCP for Blender タブを開きます。サーバーは Blender と一緒に起動しますが、動いていなければ Start MCP Server をクリックしてください。
# アドオンを Blender のアドオンフォルダに blender_mcp.py としてコピーする(.bak も残す) uvx mcp-for-blender install-addon # 見つかったアドオンフォルダを一覧表示する uvx mcp-for-blender addon-paths
Codex に Blender MCP を導入する
Codex CLI、デスクトップアプリ、IDE 拡張は ~/.codex/config.toml を共有するので、1回の設定で3つすべてに効きます。コマンドは README と OpenAI の Codex MCP ドキュメントから写したもので、実行はしていません。uv と Blender アドオンは、Claude Code の手順と同じようにインストールしてください。
CLI でサーバーを追加する
Codex は、次に起動したときにツールを表示します。Codex のターミナル UI で
/mcpと入力すると、有効なサーバーが一覧表示されます。デスクトップアプリでは、同じことを Settings → MCP servers → Add server で行います。名前はblender、STDIO、コマンドはuvx mcp-for-blenderです。# README のコマンド codex mcp add blender -- uvx mcp-for-blender # 確認:blender が enabled と表示されるはず codex mcp listまたは config.toml を編集する
[mcp_servers.blender]テーブルは README のものです。envの行は Codex のドキュメントに従っています。ドキュメントはテーブルのキーとしてenv、startup_timeout_sec(既定は 10)、tool_timeout_sec(既定は 60)を挙げています。Blender の長い処理がタイムアウトするなら、tool_timeout_secを上げてください。# または ~/.codex/config.toml に手で書く(Codex CLI、デスクトップアプリ、IDE 拡張で共通) [mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"]任意:Codex プラグイン
README が Codex に勧めているものです。チャットの中にライブの Blender ビューポート、アセットのサムネイル選択、シーンのオブジェクトへの @メンションが表示されます。Codex のプラグインディレクトリにはまだないので、リポジトリから追加します。
git clone https://github.com/ahujasid/blender-mcp.git codex plugin marketplace add ./blender-mcp/integrations/codex # そのあと Codex を再起動し、プラグインのディレクトリから "MCP for Blender" をインストールする
代わりに Blender Lab の公式サーバーを導入する
Blender Lab のセットアップ wiki では、Blender 5.1 以降にそのアドオンをインストールし、サーバーをホームフォルダに clone し、MCP クライアントを uv でそこに向けます。以下は wiki の clone コマンドと設定を記録したもので、実行はしていません。Claude を使っているなら、このサーバーは Claude のコネクタディレクトリにも載っていて、アドオンが必要だと書かれています。
git clone https://projects.blender.org/lab/blender_mcp.git を実行し、続けて {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}} を設定します。
2つのプロジェクトを同じ blender という名前で登録しないでください。mcp-for-blender の README も、サーバーのインスタンスは一度に1つだけ動かすよう書いています。たとえば Cursor か Claude Desktop のどちらか一方で、両方ではありません。
例:エージェントにローポリの小物を作らせて GLB を書き出す
Blender を開いてアドオンが動いている状態で、エージェントは execute_blender_code でモデリングし、look で結果を確認します。これはドキュメントをもとに書いたもので、最初から最後までは実行していないので、結果は変わることがあります。GLB を glTF-Transform で圧縮して three.js で読み込む方法は、vibegamer.io の Blender MCP ガイドをご覧ください。
.blend ファイルを保存する
エージェントは開いているファイルを直接編集します。README の警告は、
execute_blender_codeを使う前に必ず作業を保存することです。エージェントに指示する
サイズ、三角形の上限、書き出し先を伝えます。Blender の glTF エクスポーターは Principled BSDF ノードからベースカラーを読むので、単色のベースカラーならきれいに書き出せます。README には、複雑な操作は小さなステップに分ける必要があるかもしれない、とも書かれています。
Blender MCP のツールを使ってください。ブラウザゲーム用に、ローポリの木箱を作ります。 - 1 m の立方体で、地面(z = 0)の上に置き、原点は底面の中心。 - 面取りした板と角の補強材で、三角形は 800 未満。 - マテリアルは Principled BSDF のベースカラーだけ(木、黒っぽい金属)。画像テクスチャは使わない。 - モディファイアを適用し、すべてを "Crate" という名前の1つのオブジェクトに結合する。 - look ツールでいくつかの角度から確認し、浮いている部分があれば直す。 - "Crate" だけを選択し、GLB として ./public/models/crate.glb に書き出す。 実行する前に、毎回スクリプトを見せてください。実行前に書き出しスクリプトを読む
書き出しは通常、Blender の
export_sceneAPI のパラメーターを使った、次のような呼び出しで終わります。GLB は、メッシュ、マテリアル、テクスチャを1つのファイルにまとめます。パスがプロジェクトの中にあることを確認してください。import bpy bpy.ops.export_scene.gltf( filepath="/path/to/your-game/public/models/crate.glb", export_format='GLB', # メッシュ、マテリアル、画像を1つのバイナリファイルにまとめる use_selection=True, # 選択中の "Crate" だけ export_apply=True, # 書き出し時にモディファイアを適用 export_yup=True, # +Y が上 )
Blender MCP は安全か? 制限しておくべきこと
エージェントに Blender の中の Python シェルを渡すのと同じだと考えてください。以下は mcp-for-blender の README にある内容です。
- 任意の Python:
execute_blender_codeは、エージェントが書いたどんな Python でも実行します。README はこれを危険になりうるとして、必ず先に作業を保存するよう書いています。承認する前にスクリプトを読んでください。 - セーフモード:
BLENDER_MCP_SAFE_MODE=1を設定すると、実行前にスクリプトを検証します。ファイルの直接の読み書き、ほかのプログラムの実行、ネットワークアクセス、永続的なコードはブロックされます。モデリング、マテリアル、レンダリング、保存、インポート/エクスポートは引き続き使えます。 - ソケットの認証なし:アドオンのサーバー(既定のポートは 9876)には認証も暗号化もないので、そのポートに届く人なら誰でも Blender で Python を実行できます。信頼できるネットワーク上でない限り、
BLENDER_HOSTはlocalhostのままにしてください。 - テレメトリ:既定では、匿名のインストール ID、セッション ID、ツール名、成功の可否、所要時間、バージョン、OS、タイムスタンプを送信します。プロンプト、生成されたコード、スクリーンショット、シーンのデータは、オプトインしたときだけ送信され、オプトインしたデータは AI モデルの学習に使われることがあります。完全にオフにするには
DISABLE_TELEMETRY=trueを設定します。 - サードパーティのキー:3D 生成や一部のアセットソースは、環境変数で渡す API キー(たとえば
BLENDERMCP_MESHY_API_KEY)を使います。Poly Pizza のモデルは約 69% が CC-BY なので、CC0 に絞らない限りクレジット表記が必要です。
Blender MCP か、Blender スキルか
MCP サーバーは、エージェントに起動中の Blender へのライブな接続を与えます。スキルは、ワークフローのための文章の指示とスクリプトを与えます。たとえば EL4CTEO/blender-skills(Claude Code や Codex などで使える、Blender 5.2 LTS 以降向けの28個のワークフロースキル)です。両者は組み合わせるとうまく働きます。スキルがゲームに使えるアセットの作り方をエージェントに教え、MCP サーバーがそれを開いているシーンで実行させます。
Blender やゲーム制作のスキルと MCP サーバーは、ゲーム開発スキルにまとめています。vibegamer.io のゲーム開発エージェントスキルでも比較しています。
Crewmark:コーダーと同じボードにいる3Dアーティスト
Blender MCP は一度に1つのセッションを前提にしています。あなたが指示し、エージェントがモデリングし、あなたがレビューします。ほかのエージェントがゲームのコードを書いている間に、何日もアセットを作り続けるエージェントがほしいなら、Crewmark という選択肢もあります。
Crewmark では、各エージェントが AI 社員です。職種を持ち、あなた自身のマシンで動く、長時間稼働のセッションです。Claude Code と Codex の社員はネイティブに動き、OpenCode、DeepSeek Harness、Gemini などのほかのエージェントは ACP(acpx)経由で接続します。作業は共有の issue ボードを流れ、あなたと社員が issue を割り当て、コメントし、お互いに @メンションし、ステータスを変更します。コーディングの社員が Blender の社員に新しい小物を頼むのも、その issue で @メンションするだけです。社員はスケジュール(ハートビート)で、またメンションされるたびに起動するので、あなたが橋渡しをしなくても作業が始まります。
Blender MCP の代わりにはなりません。サーバーを入れた社員は、引き続きそれを使います。Crewmark が加えるのは、その周りの職種、ボード、起動の仕組みです。
よくある質問
Blender MCP は無料ですか?
はい。mcp-for-blender は MIT ライセンスのオープンソースです。サイトによると、3D 生成を除くすべての機能が無料プランで使え、3D 生成には Premium プラン(月額 $10 から)か自分のプロバイダーの API キーが必要です。Blender Lab のサーバーは GPL-3.0 で無料です。
Blender MCP は安全ですか?
エージェントが書いたどんな Python も Blender の中で実行し、ソケットサーバーには認証がありません。先に作業を保存し、承認する前にスクリプトを読み、localhost のままにして、BLENDER_MCP_SAFE_MODE=1 を設定してファイルアクセス、ほかのプログラム、ネットワークアクセスをブロックしてください。利用状況のテレメトリは DISABLE_TELEMETRY=true でオフにできます。
公式の Blender MCP サーバーはありますか?
はい。Blender Lab が projects.blender.org で blender_mcp を公開していて(GPL-3.0、Blender 5.1 以降)、Claude のコネクタディレクトリにも Blender Lab 提供として載っています。人気の mcp-for-blender は、Blender Foundation とは無関係のサードパーティプロジェクトです。
Claude Code に Blender MCP を追加するには?
uv をインストールし、claude mcp add blender uvx mcp-for-blender を実行し、claude mcp list で確認します。そのあと uvx mcp-for-blender install-addon で Blender アドオンをインストールして有効にします。または README のワンコマンドインストーラーを実行すれば、Claude Code の設定も済みます。
Codex に Blender MCP を追加するには?
codex mcp add blender -- uvx mcp-for-blender を実行するか、~/.codex/config.toml に command = "uvx" と args = ["mcp-for-blender"] を持つ [mcp_servers.blender] テーブルを追加します。CLI、デスクトップアプリ、IDE 拡張はこのファイルを共有します。README には、チャットの中にライブのビューポートを表示する Codex プラグインもあります。
Blender MCP と Blender スキルのどちらを使うべきですか?
エージェントに起動中の Blender シーンを操作させたいときは MCP、検証済みのワークフローを渡したいときはスキルを使います。多くの構成では両方を使います。スキルがワークフローを記述し、MCP サーバーがそれを実行します。
2026年11月21日に、mcp-for-blender の README、Blender Lab の blender_mcp リポジトリと wiki、Claude Code と Codex の MCP ドキュメント、Blender の glTF 書き出しドキュメントでコマンドと機能を確認。インストールコマンドは実行していません。