Skip to main content
Glama
deenesjakoruzh
tattooinmtl

Blender MCP

by tattooinmtl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Blender MCP — Blender 5.2 LTS 用 Streamable-HTTP ブリッジ

Model Context Protocol ブリッジ。あらゆる MCP クライアント（Antigravity、Cursor、Claude Desktop、VS Code 1.101+、MiniMax Code、Windsurf、Continue、Cline、OpenCode、Codex、MCP Inspector、…）が自然言語で Blender 5.2 LTS を操作できるようにします。

このアドオンは、Blender 内のバックグラウンドスレッド上で MCP Streamable-HTTP サーバーを実行します。クライアントはそれを指すだけでよく、サブプロセスの生成も、管理が必要なソケットペアもありません。

なぜこの構成なのか

  • Blender 内での単一インストールパス。 MCP サーバーは bpy を使用してインプロセスで実行されるため、uvx/pipx の操作も、同期を保つソケットペアも不要です。

  • localhost 上の Streamable HTTP。 あらゆる最新の MCP クライアントで動作します。

  • アドオン内の手作り MCP サーバー。 Blender 5.2 LTS にはデフォルトで外部パッケージなしの Python 3.13 がバンドルされています。~300行の MCP サーバーは、mcp[cli] を引き込んで sys.path を編集するよりも移植性が高いです。

  • クライアント非依存。 独自のプラグインフォーマットはありません。HTTP エンドポイント（またはそれを行う stdio プロキシ）にアクセスできる MCP クライアントならどれでも動作します。

Related MCP server: blender-mcp

プロジェクト構成

blender_addon_mcp/
├── README.md                      ← you are here
├── LICENSE                        ← MIT
├── pyproject.toml                 ← dev tooling for the add-on (ruff, mypy, pytest)
├── .gitignore
├── addon/
│   └── blender_mcp_addon/         ← zips into a Blender-installable .zip
│       ├── __init__.py            ← bl_info, register/unregister, preferences
│       ├── server/
│       │   ├── __init__.py
│       │   ├── mcp_server.py      ← MCP protocol (initialize, tools/list, tools/call, ping)
│       │   ├── transport.py       ← stdlib http.server, runs on a daemon thread
│       │   └── protocol.py        ← JSON-RPC 2.0 + MCP 2025-03-26 types
│       ├── tools/
│       │   ├── __init__.py        ← tool registry
│       │   ├── scene.py           ← scene_info, frame control
│       │   ├── objects.py         ← list, get, create, delete, transform
│       │   ├── materials.py       ← create, assign, modify
│       │   ├── modifiers.py       ← add, set params, remove
│       │   ├── render.py          ← render_image, screenshot_viewport
│       │   └── code.py            ← execute_python (with confirmation)
│       └── utils/
│           ├── __init__.py
│           ├── bpy_helpers.py     ← bpy → JSON serialization
│           └── safe_eval.py       ← ast-validated code execution
├── scripts/
│   ├── install_addon.ps1          ← zip and install into Blender
│   ├── blender_mcp_proxy.js       ← optional stdio/socket ↔ HTTP bridge for
│   │                                Antigravity builds that don't accept `url`
│   └── start_blender_mcp_bridge.ps1  ← start/stop/status lifecycle for the bridge
├── examples/
│   ├── mcp-configs.md             ← copy-paste configs for every major MCP client
│   ├── basic_scene.md
│   ├── material_setup.md
│   └── render_workflow.md
└── docs/
    ├── architecture.md
    ├── blender_5_2_notes.md
    └── tools_reference.md

クイックスタート

1. アドオンのインストール

# clone
git clone https://github.com/tattooinmtl/Blender_MCP.git
cd Blender_MCP

# install the add-on into every Blender version on this machine
pwsh ./scripts/install_addon.ps1

2. Blender でサーバーを有効化

  1. Blender を開きます。

  2. Edit → Preferences → Add-ons → 「Blender MCP」を検索 → チェックボックスをオンにします。

  3. ポート（デフォルト 8765）を設定し、Start Server をクリックします（または 3D ビューポートのサイドバーにある Blender MCP パネルを使用します）。

  4. コンソールに次のように表示されます：

    [Blender MCP] Server listening on http://127.0.0.1:8765/mcp

3. MCP クライアントを接続

使用するクライアントを選び、examples/mcp-configs.md から該当するスニペットを貼り付けます。Antigravity の url 形式が最もシンプルです：

{
  "mcpServers": {
    "blender": { "url": "http://127.0.0.1:8765/mcp" }
  }
}

Cursor、Claude Desktop、VS Code、MiniMax Code、Windsurf、Continue、Cline、MCP Inspector 用のスニペットはすべてそのファイルにあります。

4. 動作確認

任意の MCP クライアントのチャットで：

blender サーバーを使用: ping。

エージェントが ping に対して tools/call を呼び出し、空の成功結果を報告するのが確認できるはずです。ターミナルから：

curl -s -X POST http://127.0.0.1:8765/mcp `
  -H "Content-Type: application/json" `
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}'

BlenderMCP Dominator バンドル

このリポジトリには、完全な DomiNations/OpenCivilizations プロジェクトも blender_mcp_addon/dominator/ としてアドオン内に同梱されています。

追加ツール：

ツール

目的

dominator_health_check

アドオン、バンドル、MCP エンドポイント、Node/npm、MongoDB、Redis を検証

dominator_setup_scene

Dominator レンダーシーンを設定

dominator_build_unit

プロシージャルユニットを構築（例：ranged_shooter）

dominator_build_building

プロシージャルビルディングを構築（wall、town_center）

dominator_render_asset

シーンを PNG にレンダリング

dominator_list_units

ユニットビルダーを一覧表示

dominator_list_buildings

ビルディングビルダーを一覧表示

dominator_apply_nation_palette

国家マテリアルパレットを適用

公開ツール

ツール

目的

読み取り専用

get_addon_info

機能ハンドシェイク — 名前、バージョン、プロトコル、ツール一覧。最初に呼び出してください。

はい

scene_info

シーンの概要（オブジェクト、ライト、カメラ、フレーム）

はい

list_objects

シーンオブジェクトを一覧表示、オプションでタイプフィルター

はい

get_object

オブジェクトの詳細（位置、回転、スケール、モディファイア、マテリアル）

はい

create_object

プリミティブを作成（cube、sphere、plane、cylinder、cone、torus、empty、camera、light）

いいえ

delete_object

名前でオブジェクトを削除

いいえ

transform_object

位置/回転/スケールを設定

いいえ

set_material

Principled BSDF を使用してマテリアルを作成または割り当て

いいえ

set_texture

画像ファイルをマテリアル入力（base_color、roughness、normal など）に適用

いいえ

import_asset

GLB/GLTF/FBX/OBJ/STL/PLY/DAE/USD/X3D/ABC をインポート

いいえ

add_modifier

モディファイアを追加（subdivision、mirror、solidify、array、bevel）

いいえ

remove_modifier

名前でモディファイアを削除

いいえ

frame_get / frame_set

タイムラインの読み取り / 移動

混合

render_image

現在のフレームをファイルにレンダリング

いいえ

screenshot_viewport

現在のビューポートをキャプチャ

いいえ

execute_python

任意の bpy コードを実行（ast 検証で保護）

いいえ

ping

ヘルスチェック

はい

完全なスキーマと例については docs/tools_reference.md を参照してください。

開発

# syntax-check the add-on (Blender's Python is at <blender>/python/bin/python.exe)
python -m py_compile addon/blender_mcp_addon/__init__.py
python -m py_compile addon/blender_mcp_addon/server/mcp_server.py
# ...etc

# lint
ruff check addon/
mypy addon/

# test the MCP server in isolation (no bpy required)
pytest addon/tests/ -v

ライセンス

MIT。LICENSE を参照してください。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Blender MCP VXAI

    VxASI
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables natural language control of Blender 3D through MCP clients, allowing creation, modification, and manipulation of 3D models, animations, and scenes.
    300
    MIT

  • blender-mcp

    sandraschi
    A
    license
    C
    quality
    A
    maintenance
    Enables AI-powered control of Blender through natural language, allowing users to create, manipulate, and automate 3D scenes, objects, materials, animations, and more via Claude or other MCP clients.
    71
    62
    MIT

  • Blender MCP

    tattooinmtl
    A
    license
    Not graded
    quality
    C
    maintenance
    This server enables natural language control of Blender 5.2 LTS through any MCP client, allowing scene inspection, object and material manipulation, rendering, and safe Python execution.
    1
    MIT

  • Blender MCP

    tattooinmtl
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables any MCP client to drive Blender 5.2 LTS through natural language, with tools for scene inspection, object creation and transformation, material and modifier handling, rendering, viewport capture, and guarded Python execution.
    2
    MIT