Skip to main content
Glama
deenesjakoruzh
tattooinmtl

Blender MCP

by tattooinmtl
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Blender MCP — MiniMax Connector for Blender 5.2 LTS

Model Context Protocol 브리지로, MiniMax Code(및 모든 MCP 클라이언트)가 자연어를 통해 Blender 5.2 LTS를 구동할 수 있게 합니다. 두 가지 아티팩트로 제공됩니다.

Artifact

설명

위치

Blender add-on

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 add-on이 Blender 측 상태의 소스 오브 트루스입니다. MiniMax 플러그인은 add-on의 HTTP 엔드포인트를 호출하는 가벼운 클라이언트입니다. MiniMax 쪽에서는 Python 프로세스가 생성되지 않으므로 포트 누출이나 라이프사이클 문제가 없습니다.

Why we use this structure

  • Blender 내부 단일 설치 경로 — MCP 서버가 bpy를 사용하여 프로세스 내에서 실행되므로 uvx/pipx 작업이 필요 없고, 동기화할 소켓 쌍도 없습니다.

  • Streamable HTTP on localhost — 모든 최신 MCP 클라이언트(MiniMax Code, Claude Desktop, Cursor)와 호환되며 Blender를 재시작해도 유지됩니다.

  • Hand-rolled MCP server in the add-on — Blender 5.2 LTS는 기본적으로 외부 패키지가 없는 Python 3.13을 번들로 제공합니다. 약 300줄짜리 MCP 서버는 mcp[cli]를 가져오고 sys.path를 수정하는 것보다 휴대성이 좋습니다.

  • MiniMax Plugin V1 with streamable-http capability — 플러그인은 아무것도 생성하지 않으며, 단순히 Blender add-on의 엔드포인트를 가리킬 뿐입니다.

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. Edit → Preferences → Add-ons로 이동합니다.

  3. "Blender MCP"를 검색하고 박스를 선택하여 활성화합니다.

  4. 포트(기본값 8765)를 설정하고 Start Server를 클릭합니다(또는 3D Viewport 사이드바의 Blender MCP 탭에서 시작).

  5. 콘솔에 [Blender MCP] Server listening on http://127.0.0.1:8765/mcp가 표시됩니다.

3. 확인

MiniMax Code 채팅에서 다음과 같이 요청합니다.

Blender 커넥터를 사용하세요: 현재 씬의 처음 5개 오브젝트를 나열하세요.

실행 중인 Blender에 대해 에이전트가 tools/list를 호출하는 것을 볼 수 있습니다.

노출된 도구

도구

용도

읽기 전용

get_addon_info

기능 핸드셰이크 — 이름, 버전, 프로토콜, 도구 목록. 먼저 호출하세요.

예

scene_info

씬 요약(오브젝트, 조명, 카메라, 프레임)

예

list_objects

씬 오브젝트 나열, 선택적 유형 필터

예

get_object

오브젝트 전체 세부 정보(위치, 회전, 스케일, modifier, 머티리얼)

예

create_object

프리미티브 생성(cube, sphere, plane, cylinder, cone, torus, empty, camera, light)

아니오

delete_object

이름으로 오브젝트 삭제

아니오

transform_object

위치/회전/스케일 설정

아니오

set_material

Principled BSDF로 머티리얼 생성 또는 지정

아니오

set_texture

이미지 파일을 a material의 입력(base_color, roughness, normal 등)에 적용

아니오

import_asset

GLB/GLTF/FBX/OBJ/STL/PLY/DAE/USD/X3D/ABC 가져오기

아니오

add_modifier

Modifier 추가(subdivision, mirror, solidify, array, bevel)

아니오

remove_modifier

이름으로 modifier 제거

아니오

frame_get / frame_set

타임라인 읽기 / 이동

혼합

render_image

현재 프레임을 파일로 렌더링

아니오

screenshot_viewport

현재 뷰포트 캡처

아니오

execute_python

bpy코드 실행(ast 검증으로 보호됨)

아니오

ping

반드시 응답

예

MiniMax 플러그인은 에이전트가 한눈에 볼 수 있는 도구 인덱스, 안전 규칙, 공통 레시피를 제공하는 Skill(blender-mcp-quickstart)도 제공합니다. 사소한 작업을 하기 전에 읽어보세요.

전체 스키마와 예시는 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 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