MCP for Blender 是什么:用自然语言控 Blender

MCP for Blender(原名 blender-mcp)是社区维护的 Blender MCP 插件:把 Blender 接到 Claude Desktop、Claude Code、Codex、Cursor 等 MCP 客户端,用自然语言创建、改材质、看多视角校验,并让模型直接写 Blender Python。截至 2026-11-06,仓库 MIT,GitHub 33,426 星;PyPI 包 mcp-for-blender 当前 2.2.7,要求 Python ≥ 3.10。与 Blender Foundation 无官方隶属关系。
它是什么
作者 Sid Ahuja 维护的第三方集成:Agent 通过 MCP 工具创建/修改/删除物体、调材质与颜色、做多角度与线框/X 光校验,也可拉取 Poly Haven、Sketchfab、Poly Pizza 等资产,或走 Meshy / Tripo / Hyper3D / Hunyuan3D 等生成通路(部分生成能力在 Premium 说明里,可不自备 API Key)。PyPI 旧名 blender-mcp 仍可跑,新装应使用 mcp-for-blender。
| 仓库 | github.com/ahujasid/mcp-for-blender |
|---|---|
| 作者 | Sid Ahuja(ahujasid) |
| 许可证 | MIT |
| 热度 | GitHub 33,426 星(GitHub API,2026-11-06 14:10 北京时间) |
| 语言 / 运行要求 | Python;需本机 Blender,以及 uv(官方强调用官方安装器,不要 pip install uv)。MCP 客户端任选其一即可。 |
| 最新版本 | PyPI mcp-for-blender 2.2.7(截至 2026-11-06);仓库无 GitHub Release 标签,main 最近提交 2e4b0bc(2026-11-04 21:04 北京时间,version bump)。 |
解决什么问题
用提示词驱动 Blender 时,常见问题是 Agent 看不到当前物体树,改完也不能自动换视角验收。MCP for Blender 用 socket 把场景状态和工具调用接进 MCP,让 Agent 按工具改场景,再用渲染或多视角结果自检。适合快速搭场景、改材质、批量摆物体;复杂拓扑和生产渲染仍要人来收。
怎么用
# macOS / Linux
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh
# Windows PowerShell
irm https://www.mcp-for-blender.com/install.ps1 | iex
# 已有 uv 时
uvx mcp-for-blender setup
安装脚本会尽量识别本机 MCP 客户端、写入 blender 条目(改前存 .bak),并安装、启用 Blender 插件。完成后完全退出再打开 AI 客户端(Windows 注意托盘残留),打开 Blender;插件在启动时拉起服务。视口按 N 打开侧栏「MCP for Blender」可确认状态。
# 手动:Claude Desktop 配置示例
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}
# Claude Code / Codex
claude mcp add blender uvx mcp-for-blender
codex mcp add blender -- uvx mcp-for-blender
# 单独装插件
uvx mcp-for-blender install-addon
官方提醒:同一时间只跑一个 MCP 服务实例(例如 Cursor 与 Claude Desktop 不要双开)。环境变量可改 BLENDER_HOST / BLENDER_PORT(默认 localhost:9876)。Docker 场景可把宿主机写成 host.docker.internal;需要安全模式时在容器 args 里加 -e BLENDER_MCP_SAFE_MODE=1。
README 列出的能力包括双向通信、物体与材质操作、多视角/线框/X 光与动画条校验,以及让模型直接写 Blender Python。资产侧可接 Poly Haven、Sketchfab、Poly Pizza;AI 生成网格可走 Meshy、Tripo、Hyper3D Rodin、Hunyuan3D。是否另购 Premium、是否自备云厂商密钥,以官网当下说明为准。
实测
- 版本:PyPI JSON 接口返回
mcp-for-blender==2.2.7、requires-python >=3.10(2026-11-06 核验)。 - 许可证与活跃度:SPDX MIT;main 在 2026-11-04 仍有功能提交(持久监听地址、Hyper3D 多图输入等),近 30 天维护正常。
- 安全模式:README 写明默认 Agent 可在 Blender 内跑任意 Python;
BLENDER_MCP_SAFE_MODE=1会预检脚本,拦截直接读写文件、启动外部进程、联网、安装常驻代码等,正常建模/材质/渲染/导入导出仍可用。 - 遥测:默认仅匿名用量(安装 ID、会话、工具名、成败、耗时、版本、OS);提示词、代码、截图、场景数据需偏好里勾选才采集。全关:
DISABLE_TELEMETRY=true uvx mcp-for-blender,或在 MCPenv里写入同名变量。
适合谁,不适合谁
适合:本机已有 Blender,想用 Claude / Cursor / Codex 做提示词辅助建模、材质和简单场景搭建的人;需要把 3D 工作流接进 MCP 工具链的团队。
不适合:没有 Blender、或不想给 Agent 本机 3D 场景执行权的环境;只要纯 Web/CAD 零件导出可看站内即将介绍的 text-to-cad。涉及付费生成通道时对照官网 Premium 说明,本篇只整理开源 MCP 与插件主路径。
- GitHub · ahujasid/mcp-for-blender(README、LICENSE;星数取自 API 2026-11-06)
- PyPI · mcp-for-blender 2.2.7
- mcp-for-blender.com 官网
- uv 官方文档