notes
GamesVrchat

Blender MCP セットアップ

Claude Desktop から Blender を操作するための blender-mcp (addon + MCP サーバー) の導入手順

要点: Blender 側に addon.py、Claude 側に uvx blender-mcp を登録し、N パネルから接続する。

設定 (Claude Desktop)#

claude_desktop_config.json (Claude > Settings > Developer > Edit Config):

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

Windows で uvx が見つからない場合:

{
  "mcpServers": {
    "blender": {
      "command": "cmd",
      "args": ["/c", "uvx", "blender-mcp"]
    }
  }
}

手順#

uv をインストール#

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

Blender アドオンを導入#

ahujasid/blender-mcp から addon.py をダウンロードし、Blender の Edit → Preferences → Add-ons → Install で選択。「Interface: Blender MCP」を有効化する。

Blender 側でサーバー起動#

3D Viewport で N キー → BlenderMCP タブ → Connect to Claude (バージョンにより Start MCP Server)。ポートは 9876。

BlenderMCP パネル

Claude Desktop を再起動#

設定を保存して再起動すると、ツールアイコンに Blender 系ツール (get_scene_info, execute_blender_code 等) が並ぶ。

Claude のツール一覧

注意点#

execute_blender_code は任意の Python コードを Blender 内で実行する。作業前に必ず .blend を保存する。 誤操作でシーンが壊れても Ctrl+Z で戻れないケースがある。

  • uvx blender-mcp をターミナルで手動実行しない。Claude Desktop が起動時に spawn する
  • MCP サーバーの接続先は 1 つだけ。Cursor と Claude Desktop の同時利用は不可
  • テレメトリはデフォルト ON。無効化は Preferences → Add-ons → Blender MCP のチェックボックス
  • Poly Haven 連携 (テクスチャ / HDRI の自動ダウンロード) はパネルのチェックボックスでオプトイン
  • 最初の 1 コマンドが通らないことがある。2 回目以降は安定する。ダメなら Blender 側サーバーと Claude を両方再起動

関連#

最終更新:

On this page