Skip to main content
Glama
deenesjakoruzh
tattooinmtl

Blender MCP

by tattooinmtl
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Blender MCP — Blender 5.2 LTS 向け MiniMax Connector

MiniMax Code（および任意の MCP クライアント）が自然言語で Blender 5.2 LTS を操作できるようにする、Model Context Protocol ブリッジです。2 つのアーティファクトとして提供されます。

アーティファクト

説明

配置場所

Blender アドオン

Blender 内部のバックグラウンド スレッドで MCP Streamable-HTTP サーバーを実行する Python アドオン

addon/blender_mcp_addon/ → Blender にインストール

MiniMax Plugin V1

実行中の Blender MCP サーバーに接続し、そのツールをエージェントに公開するローカル・MiniMax Code プラグイン

connector/ → C:/Users/.../.minimax/plugins/blender-mcp/ にインストール

Blender アドオンが、Blender 側の状態の正準情報源（source of truth）です。MiniMax プラグインはアドオンの HTTP エンドポイントを呼び出すだけの薄いクライアントであり、MiniMax 側で Python プロセスを起動することはないため、ポートの漏えいやライフサイクルの不整合は発生しません。

この構成にした理由

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

  • localhost 上の Streamable HTTP — あらゆる最新の MCP クライアント（MiniMax Code、Claude Desktop、Cursor）で動作し、Blender を再起動しても維持されます。

  • アドオン内で自前実装する MCP サーバー — Blender 5.2 LTS はデフォルトで外部パッケージのない Python 3.13 をバンドルしています。mcp[cli] を持ち込んで sys.path を編集するよりも、約 300 行の MCP サーバーの方が移植性に優れます。

  • streamable-http 機能を備えた MiniMax Plugin V1 — プラグインは何も起動しません。ただ Blender アドオンのエンドポイントを指すだけです。

Related MCP server: BlenderMCP

プロジェクト構成

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.py         ← AddOnPreferences (port, auth token, autostart)
│       ├── 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
├── connector/                     ← MiniMax Plugin V1 source
│   ├── .minimax-plugin/
│   │   └── plugin.json
│   ├── servers/
│   │   └── blender.mcp.json       ← streamable-http → http://127.0.0.1:8765/mcp
│   ├── icon.png                   ← category icon (Design / 3D)
│   └── README.md
├── scripts/
│   ├── install_addon.ps1          ← zip and install into Blender
│   └── install_connector.ps1      ← copy connector into ~/.minimax/plugins/
├── examples/
│   ├── basic_scene.md
│   ├── material_setup.md
│   └── render_workflow.md
└── docs/
    ├── architecture.md
    ├── blender_5_2_notes.md
    └── tools_reference.md

クイックスタート

# 1. Clone the repository
git clone https://github.com/tattooinmtl/Minimax_Blender_MCP.git
cd Minimax_Blender_MCP

# 2. Install the Blender add-on
pwsh ./scripts/install_addon.ps1

# 3. Install the MiniMax connector plugin
pwsh ./scripts/install_connector.ps1

4. Blender で有効にする

  1. Blender を開きます。

  2. メニューから 編集 → プリファレンス → アドオン を選択します。

  3. "Blender MCP" が表示されるので検索し、チェックボックスをオンにして有効にします。

  4. ポート（デフォルトは 8765）を設定し、Start Server をクリックします（または 3D ビューポートのサイドバーにある Blender MCP タブから起動できます）。

  5. コンソールに [Blender MCP] Server listening on http://127.0.0.1:8765/mcp と表示されます。

3. 動作確認

MiniMax Code のチャットで、次のように質問します。

blender connector を使用してください。現在のシーンにある最初の 5 つのオブジェクトを一覧表示してください。

実行中の Blender に対して、エージェントが tools/list を呼び出すのが確認できます。

公開ツール

ツール

目的

読み取り専用

get_addon_info

ケイパビリティのハンドシェイク — 名前、バージョン、プロトコル、ツール一覧を取得します。最初に呼び出してください。

はい

scene_info

シーンの概要（objects, lights, cameras, frame）

はい

list_objects

シーン内のオブジェクトを一覧表示。タイプによるフィルタリングも可能

はい

get_object

オブジェクトの完全な詳細（location, rotation, scale, modifiers, materials）

はい

create_object

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

いいえ

delete_object

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

いいえ

transform_object

location / rotation / scale を設定

いいえ

set_material

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

いいえ

set_texture

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

いいえ

import_asset

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

いいえ

add_modifier

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

いいえ

remove_modifier

名前を指定してモディファイアを削除

いいえ

frame_get / frame_set

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

混在

render_image

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

いいえ

screenshot_viewport

現在のビューポートをスクリーンショット

いいえ

execute_python

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

いいえ

ping

ヘルスチェック

はい

MiniMax プラグインには、エージェント向けにツール一覧・安全ルール・一般的なレシピをひと目で確認できる Skill（blender-mcp-quickstart）も同梱されています。本格的な作業を行う前に、必ず読んでください。

完全なスキーマと例については、docs/congratulations.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 installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • BlenderMCP

    SolonaBot
    A
    license
    B
    quality
    D
    maintenance
    An MCP server that enables AI models to directly control Blender for 3D modeling, scene manipulation, and material management through natural language. It supports advanced workflows including Python code execution, viewport visualization, and integration with external asset libraries like Poly Haven and Hyper3D.
    22
    1
    MIT

  • 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.
    299
    MIT

View all related MCP servers

Related MCP Connectors

  • mcp-aichat

    MCP server for AI dialogue using various LLM models via AceDataCloud

  • mcp-producer

    MCP server for Producer/Riffusion AI music generation

  • mcp-hailuo

    MCP server for Hailuo (MiniMax) AI video generation

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tattooinmtl/Minimax_Blender_MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server