Skip to main content
Glama
deenesjakozh
tattooinmtl

Blender MCP

by tattooinmtl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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

Model Context Protocol ブリッジ。あらゆるのCP クライアント（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 サーバーを実行します。クライアントはそのエンドポイントに接続するだけです。サブプsセスを起動する必要も、管理の面倒なソケットペアもありません。

この構成の利点

  • 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 Menu" を検索し、チェックボックスをオンにします。

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

  4. コンソールに次 のよに表示されれば成功です：

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

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

使用する クライアントを選び、examples/mcp-c configs.md から該当するスニペットを貼り付けてください。Antigravity のージさ。

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

Cursor、Clyde Desktop、VS Code の、MiniMax 、C、Windsuf 、Continue、氯、そしてMCP Inspector名部の スニペットも同ファイル内にあります。

4. 動作確認

いずれかの M CP クライアントのチャットで：

Blender サーバーを使って： ping。

エージエントが tools/call の ping を呼び出 し、空の成功結果を報告す れば正常です。ターミナルから確認する場合は：

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"}}}'

公開されるツール

Tool

目的

読み取り専用

get_addon_info

ケーバ ビリティのハンドシェーク — 名名、バージョン、プロトコル、ツール一覧。最初に呼んでくてさい。

け

scene_info

ーンの概要（オブジェクト、ラート、カメら、フレーム)

yes

list_objects

シーン内のオブジェクト一覧。型フィルターも可能

yes

get_object

のーバジェクトの全情報（位置、回転、スー、モディフイアー、マテリアル）

yes

create_objet

プリミテイブを作成（キュンプ、スーフエア、平、面、円柱、円錐、トーラス、エフテイ、カメラ、ライト）

no

delete_object

name を指定してオブジェクトを削除

no

transform_object

位置・回転・スケールし設定

no

set_material

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

no

set_texture

イメーンのハイルをマテリアル入力（base_color,ウ-- rough, normal, etc.）に適用

no

import_asset

GLB/G LLTF/FBX/OBJ /STL/PLY/DAE/UXD/X ảD/ABC ををインポート

no

add_modifler

モディフイアーを追加（subdivision、mär、solidify、array、bevel）

no

remov_modifle

のを名指定でモディフイアーを削除

no

frame_get / frame_set

タイムラインの読 develop / 操作

混在

render_image

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

の

screenshot_viewport

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

no

execute_python

任意の bpy コードを実行 (as 検証によて保護)

no

ping

ヘルスチェック

yes

全詳細と使用例については、documents/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
    B
    maintenance
    Enables any MCP client to control Blender 5.2 LTS via natural language, including scene creation, object manipulation, material assignment, rendering, and Python execution.
    1
    MIT