Blender について
Blenderは、LLMを使ってBlender内の3Dシーンを作成・操作するMCP連携です。MCPサーバーとBlenderアドオンで構成され、視覚的な確認、Python実行、素材やモデルの生成に対応します。
主な機能
- 013Dオブジェクトの作成・編集・削除
- 02マテリアルと色の適用
- 03複数視点とレンダーの確認
- 04Blender内でのPython実行
- 05アセットの導入と3Dモデル生成
活用シーン
- 01プロンプトからBlenderシーンを作成
- 02オブジェクトやマテリアル、色の調整
- 03レンダーによるモデリング結果の確認
MCP 対応
MCPサーバーがBlenderアドオンのソケットサーバーに接続し、MCPクライアントにBlenderの操作機能を公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
17掲載時のツール一覧 · 3 週間前に更新
このツールにパラメーターはありません。
詳細
翻訳後に原文が更新されています。最新の内容は原文をご確認ください。
Blender 用 MCP
Blender をあらゆる LLM に接続
以前は blender-mcp でした。PyPI パッケージは mcp-for-blender になりました。
既存のセットアップは引き続き動作し、設定の変更は不要です。詳細はこちら
**免責事項:**これはサードパーティ製の統合であり、Blender が開発したものではありません
AI を活用したプロンプトによる 3D モデリング、シーンの作成、操作。
支援者
すべての支援者: このプロジェクトを支援
クイックスタート
注: PyPI パッケージ
blender-mcpは現在mcp-for-blenderになっています。既存のセットアップは引き続き動作します。uvx blender-mcpでも引き続きサーバーを起動でき、設定を変更する必要はありません。新規インストールではmcp-for-blenderを使用してください。 変更内容とその理由
1 つのコマンドで AI アプリと 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 を実行してください。
必要に応じて uv をインストールし、マシン上の MCP クライアント(Claude Desktop、Claude Code、Codex、Cursor、VS Code、Devin Desktop/Windsurf、OpenCode、Antigravity)を検出して、セットアップするクライアントを選択できるようにします。その後、Blender アドオンをインストールして有効にします。既存の設定は保持され、blender エントリを追加するだけです。変更する各ファイルの .bak も保存します。
続いて、AI アプリを完全に終了して再起動し(Windows では、システムトレイから終了してください)、Blender を開いて、何か作るように頼んでみてください。アドオンは Blender の起動時にサーバーを起動します。
自動セットアップが機能しない場合の手動セットアップ
手順は 3 つです。uv をインストールし、MCP クライアントからサーバーに接続し、Blender アドオンをインストールします。
1. uv をインストールする
# macOS
brew install uv
# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
警告: uv をインストールするまでは先に進まないでください。公式インストーラーを使用してください。
pip install uvは使用しないでください。
2. MCP サーバーをクライアントに追加する
Claude Desktop — 設定 → Developer → Edit Config
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}
Claude Code
claude mcp add blender uvx mcp-for-blender
Codex
codex mcp add blender -- uvx mcp-for-blender
Cursor / VS Code / OpenCode / Antigravity
クライアントごとの手順とワンクリックインストールボタンについては、以下の MCP クライアントのセットアップ をご覧ください。
3. Blender アドオンをインストールする
uvx mcp-for-blender install-addon
次に Blender で、編集 → プリファレンス → アドオン を開き、Interface: MCP for Blender を有効にします。
4. 接続する
アドオンは Blender の起動時にサーバーを起動します。確認するには、3D ビューポートで N を押し、MCP for Blender タブを開きます(起動していない場合は Start MCP Server をクリックしてください)。これで完了です。Claude に何か作るよう頼んでみてください。
注: MCP サーバーのインスタンスは 1 つだけ起動してください(Cursor か Claude Desktop のどちらか一方で、両方ではありません)。
目次
- クイックスタート
- 機能
- プレミアム
- コンポーネント
- インストール
- MCP クライアントのセットアップ
- Blender アドオンのインストール
- アップグレード(既存ユーザー向け)
- 使い方
- API 認証情報の永続化
- トラブルシューティング
- 技術的な詳細
- 制限とセキュリティ上の考慮事項
- テレメトリーの制御
- フィードバック
- コントリビューション
- 免責事項
- スター履歴
機能
| 双方向通信 | ソケットベースのサーバーを介してClaude AIをBlenderに接続します |
| オブジェクト操作 | Blenderで3Dオブジェクトを作成、変更、削除します |
| マテリアル制御 | マテリアルや色を適用、変更します |
| 視覚的な確認 | 複数の角度、カメラ、ワイヤーフレーム、X線、アニメーションストリップの各ビューに加え、レンダーも確認できるため、AIが自分の作業をチェックできます |
| コード実行 | AIがBlender Pythonを直接記述します |
| アセットとモデルの生成 | Poly Havenのアセット、Sketchfabのモデル、Poly Pizzaのローポリモデル、およびTripo、Hyper3D Rodin、Hunyuan3DによるAI生成3Dモデル |
プレミアム
APIキーを用意することなく、AI 3Dモデル(Hunyuan3D、Tripo、Hyper3D Rodin)をBlenderに直接生成できます。詳細はこちら
コンポーネント
システムは2つの主要コンポーネントで構成されています。
- Blenderアドオン(
addon.py) — Blender内にソケットサーバーを作成し、コマンドを受信して実行するBlenderアドオンです - MCPサーバー(
src/blender_mcp/server.py) — Model Context Protocolを実装し、Blenderアドオンに接続するPythonサーバーです
インストール
自動セットアップ
最も手早い方法は、1行のインストーラーを使うことです。uvをインストールし、MCPクライアントを設定して、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を実行してください。変更内容についてはクイックスタートをご覧ください。このセクションの以降では、手動でのセットアップについて説明します。
前提条件
- Blender 3.0以降
- Python 3.10以降
- uvパッケージマネージャー
プラットフォーム別のuvのインストール
macOS
brew install uv
Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
続いて、WindowsでuvをユーザーのPATHに追加します(その後、Claude Desktopの再起動が必要な場合があります)。
$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")
Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
~/.local/binにインストールされます。新しいシェルを開き、PATHに反映してください。
それ以外の方法については、公式サイトのインストール手順をご覧ください:uvのインストール
どのOSでも、uvの上記の公式インストーラーを使用してください。pip install uvは使用しないでください。uvxコマンドが作成されなかったり、クライアントから認識できない環境内にuvが隠れたりすることがあります。
警告: uvをインストールする前に先へ進まないでください。
クライアントからuvxを見つけられるようにする
GUIから起動したMCPクライアント(Claude Desktop、Cursor、Dock/スタートメニューから起動したVS Code)は、ターミナルのPATHを引き継ぎません。そのため、ターミナルでuvxが動作していても、単に"command": "uvx"と指定すると、**spawn uvx ENOENT**エラーが発生することがあります。その場合は、次の手順を実行してください。
which uvx(macOS/Linux)またはwhere uvx(Windows)でuvxのフルパスを調べ、"command"に指定します。例:/opt/homebrew/bin/uvxまたはC:\Users\<you>\.local\bin\uvx.exe。- Windowsでは、代わりに
"command": "cmd", "args": ["/c", "uvx", "mcp-for-blender"]で実行することもできます。 - PATHまたは設定を変更した後は、クライアントを完全に終了して再起動してください(Windows:ウィンドウを閉じるだけでなく、システムトレイから終了してください。macOS:Cmd+Q)。
Pythonのバージョンを固定する
conda/pyenvとの競合やバージョンの競合を避けてください。
uvはサーバーの実行に使用するPythonを選びます。conda(自動有効化されるbase環境)、pyenv、asdfがインストールされているマシンや、一部の依存関係にまだホイールが用意されていない新しいCPythonリリースを使用している環境では、uvがインストールに失敗するインタープリターを選ぶことがあります。PATH上にあるPythonが選ばれないように、Python 3.11を指定し、uvが管理するインタープリターを優先してください。
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["--python", "3.11", "mcp-for-blender"],
"env": { "UV_PYTHON_PREFERENCE": "only-managed" }
}
}
}
--python 3.11は、このパッケージのrequires-python >=3.10を引き続き満たします。また、UV_PYTHON_PREFERENCE=only-managedを指定すると、uvがconda、pyenv、asdf、システムのPythonを優先して選ぶことを防げます(リポジトリの.python-versionはコントリビューター向けのヒントにすぎず、uvxには影響しません)。
修正後も前回の失敗が繰り返される場合は、キャッシュを消去してください。
uv cache clean mcp-for-blender blender-mcp && uvx --refresh mcp-for-blender
uv を使わずにインストールする
制限の厳しいマシンでは、pipx を使えば uvx を完全に省略し、インストールしたコマンドをクライアントに指定できます。
pipx install mcp-for-blender
pipx ensurepath # then restart your shell / client
生成された絶対パスを "command" として使い(which mcp-for-blender / where mcp-for-blender で確認できます)、args は省略してください。
Docker で実行する
インストールする代わりに、コンテナ内で MCP サーバーを実行できます。Blender 自体は引き続きマシン上で実行され、コンテナがホストするのは MCP サーバーのみです。このサーバーが Blender アドオンに接続します。
リポジトリのルートからイメージをビルドします。
docker build -t mcp-for-blender .
次に、MCP クライアントで指定します(サーバーは標準入力/標準出力経由でクライアントと通信するため、-i フラグが必要です)。
{
"mcpServers": {
"blender": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp-for-blender"]
}
}
}
イメージの BLENDER_HOST=host.docker.internal はデフォルトで設定されており、Docker Desktop を使用するmacOS と Windowsでは、ホスト上の Blender にそのまま接続できます。
Linuxでは host.docker.internal が存在せず、アドオンは localhost のみでリッスンするため、代わりにホストネットワークを使用してください。
{
"mcpServers": {
"blender": {
"command": "docker",
"args": ["run", "-i", "--rm", "--network=host", "-e", "BLENDER_HOST=localhost", "mcp-for-blender"]
}
}
}
コンテナでセーフモードを有効にするには、"-e", "BLENDER_MCP_SAFE_MODE=1" を args に追加します。
環境変数
Blender への接続は、以下の環境変数で設定できます。
| 変数 | デフォルト | 説明 |
|---|---|---|
BLENDER_HOST | localhost | Blender ソケットサーバーのホストアドレス |
BLENDER_PORT | 9876 | Blender ソケットサーバーのポート番号 |
BLENDER_MCP_SAFE_MODE | off | 1 に設定すると、Blender で実行する前にスクリプトを検証します(下記参照) |
BLENDER_MCP_APPS | auto | MCP Apps をサポートしているものの、その機能を通知しないクライアントで、インラインのビューポートアプリを強制的に有効にするには 1 に設定します(Codex プラグインで設定されています) |
BLENDER_MCP_OPENAI_FORMS | auto | サムネイルのアセット選択ツールを強制的に有効にするには 1 に設定します(Codex プラグインで設定されています) |
例:
export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876
接続情報は CLI フラグでも渡せます。CLI フラグは環境変数より優先されます。これは、複数の Blender インスタンスを並行して実行する際に便利です。各 MCP クライアントのエントリで、環境変数の代わりに通常の引数を使い、異なるポートを指定できます。
uvx mcp-for-blender --port 9877
MCP クライアントの設定では、args のみが異なる 2 つ目のエントリを追加します。
{
"mcpServers": {
"blender": { "command": "uvx", "args": ["mcp-for-blender"] },
"blender-b": { "command": "uvx", "args": ["mcp-for-blender", "--port", "9877"] }
}
}
各インスタンスでは、Blender アドオンのパネルで対応するポートを個別に設定する必要があります。
注: アドオンのソケットサーバーには認証も暗号化もありません。そのため、そのポートに接続できる人は誰でも Blender 内で Python を実行できます。信頼できるネットワーク上にいる場合を除き、
localhostのままにしてください。また、--host/BLENDER_HOSTでリモートマシンを直接指定するのではなく、SSH トンネルを使うことをおすすめします。
セーフモード
デフォルトでは、AI は Blender 内で任意の Python コードを実行できます。BLENDER_MCP_SAFE_MODE=1 を設定すると、実行前にすべてのスクリプトをチェックし、ファイルの直接読み書き、他のプログラムの実行、ネットワークへのアクセス、スクリプト終了後も実行され続けるコードのインストールなど、リスクのあるコードをブロックします。モデリング、マテリアル、レンダリング、保存、インポート/エクスポートといった通常の Blender 作業は引き続き行えます。ブロックされたスクリプトは理由とともに AI に返されるため、修正したスクリプトで再試行できます。
MCP クライアントのセットアップ
Claude for Desktop
セットアップ手順の動画を見る(uv をすでにインストールしていることを前提とします)
Claude → Settings → Developer → Edit Config → claude_desktop_config.json に移動し、以下を追加します。
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"mcp-for-blender"
]
}
}
}
Claude Code
Claude Code CLI を使って、Blender 用 MCP サーバーを追加します。
claude mcp add blender uvx mcp-for-blender
Codex
Codex CLI、デスクトップアプリ、IDE 拡張機能はすべて同じ設定ファイル(~/.codex/config.toml)を共有するため、一度サーバーを設定すれば、3 つすべてで使えます。
Codex プラグイン(推奨)
このプラグインを使うと、チャット内にライブビューポートが表示されます(オブジェクトをクリックすると、次のメッセージに添付されます)。Poly Haven、Sketchfab、Poly Pizza のサムネイルピッカーや、シーンオブジェクト、マテリアル、コレクションを対象にした @ メンションも利用できます。まだ Codex プラグインディレクトリには登録されていないため、このリポジトリから追加してください。
git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codex
その後、Codex を再起動し、プラグインディレクトリから MCP for Blender をインストールして、チャットで MCP for Blender を使うよう依頼してください。起動すると、会話の横にあるサイドパネルにビューポートが開きます。

通常の MCP サーバー
Codex CLI にサーバーを登録します。
codex mcp add blender -- uvx mcp-for-blender
または、~/.codex/config.toml(もしくは $CODEX_HOME/config.toml)に手動で追加します。
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]
または、Codex デスクトップアプリで、Settings → MCP servers → Add server の順に進み、名前に blender を指定して、STDIO を選択し、コマンドとして uvx mcp-for-blender を入力してから、Save をクリックして再起動します。アプリが uvx を見つけられない場合は、代わりにフルパスを指定してください。詳しくは、クライアントから uvx を見つけられるようにするを参照してください。
codex mcp list で登録を確認します。blender サーバーが enabled と表示されている必要があります。ツールは、次回 Codex を起動したときに利用可能になります。
環境変数(デフォルト以外の Blender ホスト/ポートなど)を設定するには、codex mcp add に --env KEY=VALUE フラグを渡すか、設定ファイルに追加します。
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]
env = { BLENDER_HOST = "localhost", BLENDER_PORT = "9876" }
Cursor
macOS — Settings → MCP に移動し、以下を貼り付けます。
- グローバルサーバーとして使う場合は、"add new global MCP server" ボタンを使って貼り付けます
- プロジェクト専用サーバーとして使う場合は、プロジェクトのルートに
.cursor/mcp.jsonを作成して貼り付けます
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"mcp-for-blender"
]
}
}
}
Windows — Settings → MCP → Add Server に移動し、以下の設定で新しいサーバーを追加します。
{
"mcpServers": {
"blender": {
"command": "cmd",
"args": [
"/c",
"uvx",
"mcp-for-blender"
]
}
}
}
注: MCP サーバーのインスタンスは、Cursor または Claude Desktop のどちらか一方でのみ実行してください。両方で実行しないでください。
Visual Studio Code
前提条件:先に Visual Studio Code をインストールしてください。
OpenCode
{
"mcp": {
"blender-mcp": {
"type": "local",
"command": ["uvx", "mcp-for-blender"],
"enabled": true,
"environment": {
"BLENDER_HOST": "localhost",
"BLENDER_PORT": "9876"
}
}
}
}
Antigravity
{
"mcpServers": {
"blender-mcp": {
"command": "uvx",
"args": ["mcp-for-blender"],
"env": {
"BLENDER_HOST": "localhost",
"BLENDER_PORT": "9876"
}
}
}
}
Blender アドオンのインストール
uvx mcp-for-blender setup(クイックスタートを参照)を実行すると、アドオンの有効化を含め、以下の作業がすべて行われます。以下の手順は手動で行う場合のものです。
1. 推奨 — ターミナルから次を実行します。
uvx mcp-for-blender install-addon
アドオンが Blender のアドオンフォルダーに blender_mcp.py としてコピーされます。書き込み先が表示され、置き換えたファイルは .bak として保存されます。
任意:
uvx mcp-for-blender addon-pathsを実行すると、検出された Blender のアドオンフォルダーが一覧表示されます。保存先はBLENDERMCP_ADDONS_DIR=/path/to/scripts/addonsで変更できます。
2. Blender を開きます
3. Edit → Preferences → Add-ons に移動します
4. Interface: MCP for Blender(「MCP for Blender」で検索)を有効にします。まだ表示されない場合は、Install… をクリックしてコピーした blender_mcp.py/addon.py を選択するか、Blender を再起動してください。
5. 手動で行う場合 — 上記のコマンドで Blender のインストール先が見つからない場合、または手動での作業を希望する場合:このリポジトリから addon.py をダウンロードし、Blender で Edit → Preferences → Add-ons → Install… に進み、ダウンロードした addon.py を選択して有効にします。
次に、Blender のサイドバーにある MCP for Blender タブを開き(3D ビューポートで N を押します)、Start MCP Server をクリックします。詳しくは、以下の接続の開始を参照してください。
アップグレード(既存ユーザー向け)
初めての方は、クイックスタートに進んでください。既存ユーザーの方は、以下をご覧ください。
1. 次を実行します。
uvx mcp-for-blender@latest update
これにより、MCP サーバー(uv のキャッシュされたコピーを更新するか、uv tool install をアップグレードします)と、インストール済みのすべての Blender アドオンのコピーが更新され、置き換えられた各ファイルの .bak が保存されます。リリースより新しいアドオンをダウングレードすることはなく、ローカルで編集したコピーもそのまま残します。変更内容を事前に確認するには、--dry-run を追加してください。
初回は
@latestを使用してください。2.1.7 より前のリリースにはupdateコマンドがなく、uvx にそのいずれかがキャッシュされている可能性があります。
2. MCP クライアント(Claude Desktop、Cursor など)を再起動し、新しいサーバーを起動します。
3. Blender で、Blender を再起動するか、Preferences → Add-ons → Interface: MCP for Blender を無効にしてから再度有効にし、もう一度 Start MCP Server をクリックします。
クライアントが古い blender-mcp パッケージ名のまま設定されている場合、update がそのことを通知します。uvx mcp-for-blender setup を実行すると、新しい名前に切り替わります。
Note: MCP サーバーが Blender のアドオンファイルを独自に変更することはありません。起動時に、インストール済みアドオンが同梱版より古いかどうかを確認し、更新方法をログに記録します。実際にファイルを書き込むのは
updateとinstall-addonです。古いバージョンのアドオンが読み込まれている場合も、execute_codeによるフォールバックを使って軌跡のキャプチャを続けられます。
使用方法
接続の開始

- Blender で 3D ビューのサイドバーを開きます(表示されていない場合は N を押します)。
- MCP for Blender タブを見つけます。
- 使用するチェックボックスをオンにします(詳しくは、以下の機能をご覧ください)。
- Connect to Claude をクリックします。
- ターミナルで MCP サーバーが実行中であることを確認します。
Claude での使用
Claude に設定ファイルを設定し、Blender でアドオンを実行すると、MCP for Blender のツールを示すハンマーアイコンが表示されます。
![]()
機能
AI はモデリング、レイアウト、マテリアル、アニメーション、リギング、リトポロジー用の Blender Python コードを自ら記述します。MCP は Python だけではできない機能を、次の 9 つのツールで補います。
| ツール | 用途 |
|---|---|
execute_blender_code | 実行中の Blender で Python を実行します |
look | viewport、camera、angles(自動でフレームに収めた多方向のシート)、frames(アニメーションストリップ)の表示を、solid、material、rendered、wireframe、xray で描画します。また、レンダーや画像ファイルを表示します |
get_scene_info | オブジェクトごとに 1 行で、選択したフィールド(配置、マテリアル、トポロジー、ウェイトなど)を示す簡潔なシーン概要を取得します。root または query で詳細を確認できます |
generate_3d | Tripo、Hunyuan3D、Hyper3D Rodin、Meshy を使って、1 回の呼び出しでモデルを生成してインポートします。プレミアムジェネレーターが自動的に優先されます |
search_assets / import_asset | Poly Haven の HDRI、テクスチャ、モデル、Sketchfab のモデル、Poly Pizza のローポリモデルを検索またはインポートします |
get_addon_status | Blender のバージョン、アドオンのバージョン、有効になっているライブラリとジェネレーターを確認します |
disable_telemetry、record_trajectory_feedback | データ収集を制御します |
Tencent Cloud での Hunyuan3D(公式 API モード)
アドオンが呼び出す Tencent Cloud のサービスは、アカウントの所在によって異なります。
| アカウント | アドオンが呼び出すサービス | リージョン | サイドバーの切り替え |
|---|---|---|---|
| 中国本土(cloud.tencent.com) | AI3D 3.0(ai3d、バージョン 2025-05-13) | ap-guangzhou | International (Pro) account はオフのままにします(デフォルト) |
| 国際版(tencentcloud.com)、Hunyuan-to-3D (Professional) | hunyuan、バージョン 2023-09-01、PBR 有効 | ap-singapore | International (Pro) account にチェックを入れます |
国際版の認証情報を中国本土のエンドポイントに送信すると、AuthFailure.SignatureFailure または
ResourceUnavailable が発生します。SecretId/SecretKey の発行元が tencentcloud.com の場合は、切り替えをオンにしてください。
この切り替えは、サイドバーの Tencent Hunyuan 3D → Official API の下にあります。
Meshy
Meshy は、テキストプロンプトまたは参照画像から、実際の高さに合わせて原点を底面に配置したテクスチャ付き 3D モデルを生成します。そのため、モデルは現実的なサイズで地面に立った状態で読み込まれます。 Meshy API キーを使用して動作し、Premium 経由ではありません。API キーの利用には Meshy の有料プランが必要です。 Meshy API キーを取得する。 サイドバーの AI Model Generation で Meshy にチェックを入れ、Model を選んでキーを貼り付けます。
Poly Haven
Poly Haven は、約 2,400 点の HDRI、テクスチャ、モデルを公開しています。すべて CC0 で無料です。アセットを販売するのではなく、寄付によって運営されています。API キーもアカウントも不要で、気にするほどのレート制限もありません。
3D ビューのサイドバーで Poly Haven にチェックを入れます。設定はこれだけです。
使用例:
「曇りの午後の HDRI でシーンを照らし、壁に錆びた金属のテクスチャを貼って」
Claude は search_assets(source="polyhaven", query="overcast afternoon", asset_type="hdris") を呼び出します。この検索はキーワードの一致ではなく意図を理解するため、「couch」でソファが見つかり、どの言語でも機能します。帯域を消費する前に上位の結果のサムネイルを添付するには previews=3 を指定します。import_asset(source="polyhaven", id="...", asset_type="textures", apply_to=["Wall"]) を呼び出すと、テクスチャをダウンロードして一度の呼び出しで適用できます。
HDRI の場合はカテゴリーパスや天候、時刻などの属性で、テクスチャの場合は表面の用途や状態などの属性で検索結果を絞り込むこともできます。不明な属性を指定すると、有効な属性を示すエラーが返されます。
モデルは、アーティストが作成したファイルである .blend からインポートされます。glTF、FBX、USD 形式のファイルは .blend から生成されるため、マテリアルの詳細が失われます。テクスチャでは、マップから Principled マテリアルを構築し、読み取り側が存在しない再パッケージや別の規約は省略します。HDRI はファイルにパックされるため、別の場所で保存して開き直してもライティングが保持されます。また、作成済みのワールドを上書きせず、新しいワールドに読み込まれます。
ライセンスとクレジット: Poly Haven のすべてのアセットは CC0 です。商用・非商用を問わず、クレジット表記は一切不要です。ただし、
API の利用規約では、ライブ API を利用するソフトウェアに対し、アセットの提供元を明示するよう求めています。そのため、検索とインポートの応答には提供元が記載され、アセットのページへのリンクが含まれます。インポート時には、polyhaven_id、
polyhaven_url、polyhaven_authors、polyhaven_resolution、polyhaven_licence がカスタムプロパティとして、インポートされたオブジェクト、マテリアル、画像、ワールドに書き込まれます。そのため、後から .blend を開いた人も、アセットとその作成者を確認できます。
Poly Pizza
Poly Pizza には、救済された Google Poly アーカイブを含む約 10,600 点の無料ローポリモデルが収録されています。スタイライズされたゲームアセットの入手先として最適です。すべてのモデルが単体で完結する .glb で、ジオメトリは Sketchfab のものよりはるかに軽量です。
- poly.pizza/settings/api で無料の API キーを取得します
- 3D View サイドバーで Use assets from Poly Pizza にチェックを入れます
- 表示された API Key フィールドにキーを貼り付けます(または、Edit → Preferences → Add-ons → MCP for Blender に保存して、次回以降も使えるようにします)
実行例:
「Poly Pizza で CC0 ライセンスのローポリチェアを検索し、高さ 1 メートルでインポートして」
Claude は search_assets(source="polypizza", query="chair", licence="CC0") を呼び出します。この関数は、ライセンスと三角形数とともに検索結果を返します。次に、import_asset(source="polypizza", id="...", target_size=1.0) を呼び出します。
カテゴリ("Animals"、"Furniture & Decor"、"Transport"、"Nature"、"Buildings"、"People & Characters"、"Food & Drink"、"Weapons"、"Clutter"、"Objects"、"Scenes & Levels"、"Other")で絞り込むことも、アニメーション付きモデルのみを指定することもできます。
クレジット表記: Poly Pizza のカタログの約 69% は CC-BY であり、モデルを表示する場所すべてでクリエイターのクレジット表記が必要です。インポート時に、整形済みのクレジット表記が、インポートされた各ルートオブジェクトのカスタムプロパティ polypizza_attribution(polypizza_id および polypizza_licence とともに)に書き込まれます。そのため、.blend に保存され、セッション終了後も保持されます。クレジット表記が不要なモデルを使いたい場合は、licence="CC0" で絞り込んでください。
コマンド例
Claude に依頼できる内容の例を以下に示します。
| プロンプト | デモ |
|---|---|
| 「ダンジョンに、金の壺を守るドラゴンがいるローポリシーンを作成して」 | 視聴 |
| 「Poly Haven の HDRI、テクスチャ、岩や植物などのモデルを使って、ビーチの雰囲気を作って」 | 視聴 |
| 参考画像を渡して、それをもとに Blender シーンを作成する | 視聴 |
| 「現在のシーンについて情報を取得して、そこから three.js のスケッチを作成して」 | 視聴 |
| 「Hyper3D で庭のノームの 3D モデルを生成して」 | |
| 「Meshy で木製のロッキングチェアを生成して」 | |
| 「この部屋を Poly Pizza のローポリ家具で埋めて」 | |
| 「この車を赤いメタリックにして」 | |
| 「球体を作成して、立方体の上に配置して」 | |
| 「スタジオのような照明にして」 | |
| 「カメラをシーンに向けて、アイソメトリックにして」 |
永続 API 認証情報
MCP for Blender は、Blender アドオンの設定から認証情報を永続的に保存できます。
Edit → Preferences → Add-ons → MCP for Blender
ここに以下の値を保存すると、Blender を再起動しても保持されます。
- Sketchfab API Key
- Poly Pizza API Key
- Hyper3D API Key
- Hunyuan3D SecretId / SecretKey
- Hunyuan3D API URL
- Meshy API Key
ヘッドレス環境や CI では、環境変数を使って認証情報を設定することもできます。
| 変数 |
|---|
BLENDERMCP_SKETCHFAB_API_KEY |
BLENDERMCP_POLYPIZZA_API_KEY |
BLENDERMCP_HYPER3D_API_KEY |
BLENDERMCP_HUNYUAN3D_SECRET_ID |
BLENDERMCP_HUNYUAN3D_SECRET_KEY |
BLENDERMCP_HUNYUAN3D_API_URL |
BLENDERMCP_MESHY_API_KEY |
トラブルシューティング
| 問題 | 対処方法 |
|---|---|
| 接続の問題 | Blender アドオンサーバーが実行中で、MCP サーバーが Claude に設定されていることを確認してください。ターミナルで uvx コマンドを実行しないでください。最初のコマンドが実行されないことがありますが、その後は動作し始める場合があります。 |
| タイムアウトエラー | リクエストを簡潔にするか、より小さなステップに分けてみてください。 |
| Poly Haven のダウンロード中に Blender がフリーズする | アセットは Blender のメインスレッドでダウンロードされるため、転送が完了するまで UI が応答しなくなります。解像度を 1 段階上げるごとにファイルサイズはおよそ 4 倍になるため、アセットをカメラの近くに配置する場合を除き、1k または 2k を指定してください。 |
| Cloudflare のチャレンジにより Poly Pizza のダウンロードが失敗する | static.poly.pizza はボット対策の背後にあり、データセンター、VPN、クラウドの IP をブロックします。API キーに問題はありません。CDN にキーが届いていないのです。通常の接続から再試行するか、.glb を手動でダウンロードして、File → Import → glTF 2.0 を使用してください。 |
| 一度オフにしてから、もう一度オンにしてみましたか? | それでも接続エラーが発生する場合は、Claude と Blender サーバーの両方を再起動してみてください。 |
技術的な詳細
通信プロトコル
このシステムでは、TCP ソケット上でシンプルな JSON ベースのプロトコルを使用します。
- コマンドは、
typeと任意のparamsを含む JSON オブジェクトとして送信されます - 応答は、
statusとresultまたはmessageを含む JSON オブジェクトです
制限事項とセキュリティ上の考慮事項
警告:
execute_blender_codeツールを使うと、Blender で任意の Python コードを実行できます。強力な機能ですが、危険を伴う可能性があります。本番環境で使用する際は注意してください。使用する前に必ず作業を保存してください。
- Poly Haven を使用するには、モデル、テクスチャ、HDRI 画像をダウンロードする必要があります。使用しない場合は、Blender のチェックボックスをオフにしてください。
- 複雑な操作は、より小さなステップに分ける必要がある場合があります。
テレメトリの制御
テレメトリはオプトイン方式です。コンテンツの収集はデフォルトでオフになっており、明示的にオンにするまでオフのままです。
デフォルトで収集される情報(オプトイン不要): アクティブユーザー数と使用されているツールを把握するための、最小限の匿名利用記録です。ランダムに生成されたインストール ID、セッション ID、ツール名、成功したかどうか、所要時間、MCP for Blender と Blender のバージョン、オペレーティングシステム、タイムスタンプが含まれます。
オプトインしない限り、収集されない情報: プロンプト、生成されたコード、ビューポートのスクリーンショット、シーンデータ、軌跡のステップです。
オプトインするには、Edit → Preferences → Add-ons → MCP for Blender に移動し、テレメトリへの同意チェックボックスをオンにしてください。一部の MCP クライアントでは、会話の開始時に一度だけオプトインを促すメッセージが表示されることもあります。オプトインすると、収集対象にプロンプト、生成されたコード、スクリーンショット、軌跡データが追加されます。詳細は TnC をご覧ください。同じ場所でいつでもオフに戻せます。
最小限の匿名利用記録も含め、テレメトリを完全にオフにするには、環境変数を設定してください。
DISABLE_TELEMETRY=true uvx mcp-for-blender
または、MCP 設定に追加してください。
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"],
"env": {
"DISABLE_TELEMETRY": "true"
}
}
}
}
テレメトリデータが氏名やアカウントに紐付けられることはありません。MCP for Blender の改善、研究、AI モデルのトレーニングに使用される場合があります。
収集される情報の詳細と、オプトイン時に付与されるライセンスについては、TERMS_AND_CONDITIONS.md をご覧ください。
フィードバック
MCP for Blender へのフィードバックを募集しています。ご意見があれば、こちらからお寄せください。
より詳しいフィードバックについては、こちらから通話を予約できます。プロジェクト内でクレジットを記載します。
コミュニティに参加する
MCP へのフィードバックやアイデアの共有、開発への参加はこちら:Discord
貢献
貢献を歓迎します!お気軽にプルリクエストを送信してください。
免責事項
これはサードパーティによる連携機能であり、Blender が開発したものではありません。Siddharth によって作成されました。
スター履歴
Blender 向け MCP が役に立った場合は、リポジトリにスターを付けてください
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。