Blender MCP は、Claude や Codex などのAIクライアントから 3DCG ソフト Blender を操作するためのMCPサーバーだ。GitHub のスターは約3.1万で、Blender 公式ではない個人のコミュニティプラグイン(MIT)である。2026年9月にパッケージ名が mcp-for-blender に変わり、ツールは25個から9個に整理された。この記事は2026年10月18日に最新の v2.1.9 を入れて、使い方・ツール・テレメトリを確かめ直した。MCPサーバーの仕組みは MCPサーバーの作り方2026年完全ガイド:TypeScript・Python両対応チュートリアル にまとめている。
HOW IT CONNECTSつながり方
指示はlocalhostのソケットを通ってBlenderに届く
-
AIクライアント
Claude・Codex・Cursor
-
MCPサーバー
uvx mcp-for-blender
-
アドオン
Blender の中でソケットを開く
-
Blender
bpy でシーンを操作
30秒でわかる Blender MCP
・何ができる:Claude・Codex・Cursor などから、自然文で Blender のシーンを読み書きする
・2026年9月の変化:パッケージ名が mcp-for-blender に。ツールは9個に整理され、一覧は25,678→16,256バイトに減った
・つまずく点:Blender 本体とアドオンが動いていないと、ツール一覧は見えても呼び出しは全部失敗する
・注意:テレメトリは既定で有効(匿名の利用記録のみ)。止めるなら DISABLE_TELEMETRY=true
Blender MCPとは?公式との関係と2026年9月の改名
Blender MCP は、MCPクライアントからの指示を Blender の Python API(bpy)の呼び出しに変え、Blender の中で実行する。「球を10個並べて」「木のテクスチャを貼って」といった頼み方ができる。
| 項目 | 2026-10-18 の確認 |
|---|---|
| リポジトリ | ahujasid/blender-mcp(★約3.1万・フォーク約2,900) |
| 公式との関係 | Blender Foundation とは無関係と明記 |
| ライセンス | MIT |
| パッケージ | mcp-for-blender 2.1.9(2026-10-06)。blender-mcp 2.0.0 はそれを読み込むだけの包み |
| 依存 | mcp(1.26以上2未満)と httpx の2つ。仮想環境は57MB |
| 対応クライアント | Claude Desktop・Claude Code・Codex・Cursor・VS Code・Windsurf・OpenCode など |
古い記事の pip install blender-mcp や25ツールの説明は、2.x では当てはまらない。README は、既存の uvx blender-mcp の設定はそのまま動き、新しく入れるなら mcp-for-blender を使うよう書いている。
Blender MCPのインストールと使い方
SETUP導入の順番
サーバーとアドオンの両方がそろって動く
-
uv を入れる
公式インストーラで。pip install uv は使わない
-
クライアントに登録
claude mcp add / codex mcp add、または setup
-
アドオンを入れる
install-addon → Preferences で有効化
-
つなぐ
N パネルの MCP for Blender でサーバーを開始
README の手順は「uv を入れる → MCPクライアントに登録する → Blender のアドオンを入れる → つなぐ」の4つ。uv が入っていれば uvx mcp-for-blender setup が、手元のMCPクライアントを探して設定し、アドオンまで入れる。手で登録するなら次の形になる。
claude mcp add blender uvx mcp-for-blender
codex mcp add blender -- uvx mcp-for-blender
uvx mcp-for-blender install-addon
アドオンを入れたら、Blender の Edit → Preferences → Add-ons で「Interface: MCP for Blender」を有効にする。3Dビューポートで N キーを押し、MCP for Blender のタブでサーバーが動いているかを見る(止まっていれば Start MCP Server)。README は、MCPサーバーは1つのクライアントからだけ起動するよう注意している。
mcp-for-blender --help で見えるサブコマンドは install-addon・addon-paths・setup・update の4つ。Blender が見つからない環境で addon-paths を打つと「No Blender addons directories found.」が返った。
つながっているかは、get_addon_status → get_scene_info の順に呼んで確かめる。ツール一覧が見えるだけでは、Blender までつながっている証拠にならない。
【実測】ツールは9個、一覧は16,256バイトに
TOOL LIST SIZEtools/list の大きさ
ツールを9個にまとめて一覧は37%軽くなった
stdio で initialize → tools/list を送って測った(DISABLE_TELEMETRY=true で起動)。
| 項目 | v1.8.7(2026-08-27) | v2.1.9(2026-10-18) |
|---|---|---|
serverInfo |
BlenderMCP 1.29.1 | MCP for Blender 1.30.0 |
| ツール数 | 25 | 9 |
tools/list のバイト数 |
25,678 | 16,256 |
| うち説明文 | 14,042 | 8,859 |
| トークン(cl100k_base) | 6,480 | 今回は測っていない |
2.1.9 のツールは get_addon_status・get_scene_info・look・execute_blender_code・generate_3d・search_assets・import_asset・disable_telemetry・record_trajectory_feedback の9つ。v1.8.7 では Poly Haven・Sketchfab・Hyper3D・Hunyuan3D の連携がサービスごとに別のツールだったが、2.x では search_assets・import_asset・generate_3d にまとめられた。一覧のバイト数は37%減った。MCPの常駐コストは、ツールの数より引数と説明の量で決まるので、まとめ方しだいで軽くなる例といえる。
execute_blender_code は、AIが書いた任意の Python を Blender の中で実行する。Blender の Python は標準ライブラリを呼べるので、ファイルの読み書きもネットワークへの接続も原理的にできる。サンドボックスではないので、外から取り込んだ文書を読ませるセッションと同時につながない。
【実測】テレメトリは既定で有効、止め方は環境変数
配布物の config.py は v2.1.9 でも enabled: bool = True だ。README の説明は次の2段階になっている。
| 送られるもの | 条件 |
|---|---|
| ランダムなインストールID・セッションID・ツール名・成否などの最小限の利用記録 | 既定で送る |
| プロンプト・生成したコード・ビューポートのスクリーンショット・シーンのデータ | アドオンの設定で同意したときだけ |
送り先は Supabase。README は、送られたデータを改善・研究・AIモデルの学習に使うことがあると書いている。インストールIDは同じマシンで使い続けるので、厳密には匿名でなく仮名になる。
DISABLE_TELEMETRY=true uvx mcp-for-blender
この形で起動すると、ログに Telemetry disabled via environment variable が出た。MCPクライアントの設定に書いておけば毎回渡せる(README の例)。
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"],
"env": { "DISABLE_TELEMETRY": "true" }
}
}
}
ツールでの停止は確認できない
MCPツールの disable_telemetry は Blender 側に設定を送る仕組みで、Blender が起動していないと「Error turning off data collection: Could not connect to Blender.」で失敗する。v2.1.9 でも、この失敗は MCP の上では isError: false で返った。AIクライアントが isError だけを見ると、止まっていないのに成功と受け取る恐れがある。確実に止めたいときは環境変数を使う。
ほかのMCPサーバーの常駐コストと比べるなら、同じ方法で測った Notion MCP(24ツール・21,831トークン) と、ツールセットで半減させた Backlog MCP(62ツール・11,710トークン) がある。
確認したもの: PyPI の mcp-for-blender==2.1.9 を venv に入れ、stdio で initialize・tools/list・tools/call(get_scene_info・disable_telemetry)を送った。--help と addon-paths を実行。README・LICENSE・config.py・telemetry.py を確認。Blender 本体を使ったシーンの操作は未検証。
参照ソース
- ahujasid/blender-mcp — README(インストール・クライアント設定・Telemetry Control)・LICENSE(2026-10-18 参照)
- mcp-for-blender — PyPI — 版の履歴と依存(2026-10-18 参照)
- blender-mcp — PyPI — 2.0.0 が mcp-for-blender への包みであること
- 配布物
blender_mcp/config.py/telemetry.py(v2.1.9) — テレメトリの既定値と環境変数による無効化(2026-10-18 実測) - Model Context Protocol 仕様 —
tools/list/tools/callとisErrorの定義





