一个 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 服务器；客户端只需指向它即可——不会派生子进程，也没有需要照看的 socket 对。
在 Blender 内的单一安装路径。 MCP 服务器使用 bpy 在进程内运行，因此不需要 uvx/pipx 的折腾，也没有需要保持同步的 socket 对。
基于 localhost 的 Streamable HTTP。 兼容所有主流 MCP 客户端。
在插件里手写 MCP 服务器。 Blender 5.2 LTS 默认自带 Python 3.13，却不包含任何外部包。与其拖入 mcp[cli] 并修改 sys.path，手写一个 ~300 行的 MCP 服务器可移植性好得多。
与客户端无关。 没有专有插件格式。任何能够访问 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# 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打开 Blender。
进入 编辑 → 偏好设置 → 插件 → 搜索 "Blender MCP" → 勾选启用。
设置端口（默认 8765）并点击 Start Server（也可以使用 3D 视口侧边栏中的 Blender MCP 面板）。
控制台应输出:
[Blender MCP] Server listening on http://127.0.0.1:8765/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 的配置片段都在该文件中。
在任意 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"}}}'工具 | 用途 | 只读 |
| 能力握手——名称、版本、协议、工具列表。请先调用它。 | 是 |
| 场景摘要（对象、灯光、相相机、帧范围） | 是 |
| 列出场景对象，可按类型筛选 | 是 |
| 对象的完整详情（位置、旋转、缩放、修改器、材质） | 是 |
| 创建基本体（立方体、球体、平面、圆柱体、圆锥体、圆环、空物体、相机、灯光） | 否 |
| 按名称删除对象 | 否 |
| 设置位置/旋转/缩放 | 否 |
| 用 Principled BSDF 创建或指定材质 | 否 |
| 将图像文件应用到材质的输入通道（base_color、roughness、normal 等） | 否 |
| 导入 GLB/GLTF/FBX/OBJ/STL/PLY/DAE/USD/X3D/ABC | 否 |
| 添加修改器（细分、镜像、实体化、阵列、倒角） | 否 |
| 按名称移除修改器 | 否 |
| 读取/移动时间线帧 | 混合 |
| 将当前帧渲染到文件 | 否 |
| 捕获当前视口画面 | 否 |
| 运行任意 | 否 |
| 健康检查 | 是 |
完整的 schema 与示例请参阅 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/ -vMIT。详见 LICENSE。
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
MCP server for AI dialogue using various LLM models via AceDataCloud
Generate, edit, and deploy immersive 3D/WebGL web projects from any MCP assistant.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tattooinmtl/MCP_Server_blender'
If you have feedback or need assistance with the MCP directory API, please join our Discord server