Blender MCP 是什么
MCP(Model Context Protocol)给 agent 提供能操作其他程序的工具。两个 Blender MCP 项目都由相同的两部分组成:一个在 Blender 内运行小型服务器的插件,以及一个由你的 agent 启动的 MCP 服务器,后者把工具调用以 JSON 形式通过 TCP 套接字转发给插件。
多数人说的是 mcp-for-blender。它的 README 开头就声明这是第三方集成,并非 Blender 官方出品。它采用 MIT 许可证,2026 年 11 月 21 日有 35,153 个 GitHub star,PyPI 包已从 blender-mcp 改名为 mcp-for-blender(11 月 18 日发布 2.3.1 版);uvx blender-mcp 仍能启动服务器,所以旧配置继续可用。
Blender Lab 的 blender_mcp 是官方版本。它的 readme 称其为轻量级服务器,刻意做得很小,目标是用自然语言操作 Blender 的 Python API、更方便地查阅文档,以及探索复杂场景。它已列入 Claude 的连接器目录,名称为 Blender,作者 Blender Lab,经 Anthropic 验证。
mcp-for-blender 与 Blender Lab 的 blender_mcp
数据来自 2026 年 11 月 21 日的 GitHub 和 projects.blender.org 仓库。
| mcp-for-blender(社区) | blender_mcp(Blender Lab) | |
|---|---|---|
| 作者 | Siddharth Ahuja;与 Blender Foundation 无关联 | Blender Lab,Blender 项目的一部分 |
| 许可证 | MIT | GPL-3.0 |
| Blender 版本 | 3.0 或更高 | 5.1 或更高 |
| Star 数 | GitHub 上 35,153 | projects.blender.org 上 39 |
| 工具 | 九个,包括 execute_blender_code、look(视口和相机视图)、get_scene_info、素材搜索与导入(Poly Haven、Sketchfab、Poly Pizza)以及 generate_3d(Tripo、Hunyuan3D、Hyper3D Rodin、Meshy) | execute_blender_code、execute_blender_code_for_cli(后台 Blender)、blend 文件和对象摘要、get_python_api_docs、截图;内置 Python API 和手册摘录 |
| 安装 | 一条命令的安装器或 uvx mcp-for-blender;内置对 Claude Code、Codex、Cursor 等的设置 | git clone 仓库并用 uv 运行;在 Blender 里添加插件 |
| 适合 | 搭建和布置场景、导入素材、生成模型 | 检查文件、询问 Blender API,配合当前版本的 Blender |
快速安装:一次配好所有 agent
mcp-for-blender README 推荐的方式是一条命令。它会在需要时安装 uv,找出你机器上的 MCP 客户端(Claude Desktop、Claude Code、Codex、Cursor、VS Code、Windsurf、OpenCode、Antigravity),让你选择要设置哪些,然后安装并启用 Blender 插件。它只会在每个配置里添加一个 blender 条目,并为每个改动过的文件保留 .bak 备份。完成后,请彻底退出并重新打开你的 agent。
下面的命令抄自 README;我们没有运行过。把脚本通过管道交给 shell 会以你的权限运行它,所以如果你想看清每一步,请改用接下来两节的手动设置。
- 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 - 你需要 Blender 3.0 或更高版本、Python 3.10 或更高版本,以及 uv。
在 Claude Code 中安装 Blender MCP
mcp-for-blender 的手动设置。命令抄自项目 README 和 Claude Code MCP 文档;我们没有运行过。
安装 uv
uv 提供启动服务器用的
uvx命令。README 提醒不要用pip install uv,请用官方安装器。# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows winget install --id=astral-sh.uv -e注册服务器
这会把服务器保存到当前项目。加上
--scope user就能在所有地方使用;这类选项要放在--之前,--用来把它们和服务器命令隔开,这是 Claude Code 文档用的写法。在会话里,/mcp会显示同样的状态。# README 里的命令 claude mcp add blender uvx mcp-for-blender # 检查:应显示服务器已连接 claude mcp list claude mcp get blender可选:关闭遥测
README 说,在服务器的环境变量里设置
DISABLE_TELEMETRY=true即可彻底关闭遥测。Claude Code 的claude mcp add用--env传入环境变量;具体写法见 Claude Code MCP 文档。安装并启用 Blender 插件
然后在 Blender 里打开 Edit → Preferences → Add-ons,启用 "Interface: MCP for Blender"。在 3D 视口里按 N,打开 MCP for Blender 标签页;服务器会随 Blender 启动,如果没有运行,点击 Start MCP Server。
# 把插件以 blender_mcp.py 复制到 Blender 的插件文件夹(保留 .bak 备份) uvx mcp-for-blender install-addon # 列出它找到的插件文件夹 uvx mcp-for-blender addon-paths
在 Codex 中安装 Blender MCP
Codex CLI、桌面应用和 IDE 扩展共用 ~/.codex/config.toml,所以一次设置就覆盖三者。命令抄自 README 和 OpenAI 的 Codex MCP 文档;我们没有运行过。uv 和 Blender 插件的安装方式与 Claude Code 的步骤相同。
用 CLI 添加服务器
Codex 下次启动时就会显示这些工具;在 Codex 终端界面里
/mcp会列出活动的服务器。在桌面应用里,对应操作是 Settings → MCP servers → Add server,名称blender,STDIO,命令uvx mcp-for-blender。# README 里的命令 codex mcp add blender -- uvx mcp-for-blender # 检查:blender 应显示为已启用 codex mcp list或者编辑 config.toml
[mcp_servers.blender]表来自 README。env一行依据 Codex 文档,文档把env、startup_timeout_sec(默认 10)和tool_timeout_sec(默认 60)列为表的键;如果耗时较长的 Blender 操作超时,就调大tool_timeout_sec。# 或者手动编辑 ~/.codex/config.toml(Codex CLI、桌面应用和 IDE 扩展共用) [mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"]可选:Codex 插件
README 为 Codex 推荐这个:它会在聊天里显示实时的 Blender 视口、素材的缩略图选择器,以及用 @ 提及场景对象。它还不在 Codex 插件目录里,所以要从仓库添加。
git clone https://github.com/ahujasid/blender-mcp.git codex plugin marketplace add ./blender-mcp/integrations/codex # 然后重启 Codex,并从插件目录安装 "MCP for Blender"
改装 Blender Lab 的官方服务器
Blender Lab 的设置 wiki 要求你在 Blender 5.1 或更高版本里安装它的插件,把服务器 clone 到你的主文件夹,再用 uv 让 MCP 客户端指向它。下面是按 wiki 记录的 clone 命令和配置;我们没有运行过。如果你用 Claude,这个服务器也列在 Claude 的连接器目录里,目录注明需要安装插件。
git clone https://projects.blender.org/lab/blender_mcp.git,然后 {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}}
不要把两个项目注册在同一个 blender 名称下。mcp-for-blender 的 README 还说,同一时间只运行它的一个服务器实例,比如在 Cursor 或 Claude Desktop 里用,但不要两个同时用。
示例:agent 做出低多边形道具并导出 GLB
在 Blender 已打开、插件正在运行时,agent 通过 execute_blender_code 建模,并用 look 检查成果。这是我们依据文档写的,没有完整跑过一遍,所以实际结果会有差异。关于用 glTF-Transform 压缩 GLB 并在 three.js 里加载,请看 vibegamer.io 上完整的 Blender MCP 指南。
保存你的 .blend 文件
agent 会直接编辑你打开的文件。README 的警告是:使用
execute_blender_code之前,务必先保存你的工作。给 agent 下提示词
给出尺寸、三角面预算和导出路径。纯色基础色可以顺利导出,因为 Blender 的 glTF 导出器从 Principled BSDF 节点读取基础色。README 还提到,复杂的操作可能需要拆成更小的步骤。
Use the Blender MCP tools. 为一款网页游戏做一个低多边形木箱: - 1 米立方体,放在地面 z = 0 上,原点在底面中心。 - 带倒角的木板和角撑,三角面少于 800。 - 只用 Principled BSDF 基础色(木色、深色金属),不用图片贴图。 - 应用所有修改器,把所有部件合并成一个名为 "Crate" 的对象。 - 用 look 工具从几个角度检查,修复悬空的部分。 - 只选中 "Crate",导出为 GLB 到 ./public/models/crate.glb。 每个脚本运行前先给我看。在导出脚本运行前先读一遍
导出通常以类似下面的调用收尾,用的是 Blender
export_sceneAPI 的参数。GLB 把网格、材质和贴图打包进一个文件。检查路径是否在你的项目内。import bpy bpy.ops.export_scene.gltf( filepath="/path/to/your-game/public/models/crate.glb", export_format='GLB', # 一个二进制文件,包含网格、材质和图片 use_selection=True, # 只导出选中的 "Crate" export_apply=True, # 导出时应用修改器 export_yup=True, # +Y 朝上 )
Blender MCP 安全吗?该锁定什么
把它当作给了 agent 一个 Blender 里的 Python shell。以下几点来自 mcp-for-blender 的 README。
- 任意 Python:
execute_blender_code会运行 agent 写的任何 Python。README 称这有潜在危险,并要求务必先保存你的工作。批准之前先读脚本。 - 安全模式:设置
BLENDER_MCP_SAFE_MODE=1,在脚本运行前先做校验。它会阻止直接读写文件、运行其他程序、访问网络和持久化代码;建模、材质、渲染、保存和导入/导出仍然可用。 - 套接字没有认证:插件的服务器(默认端口 9876)没有认证也没有加密,所以任何能访问该端口的人都能在 Blender 里运行 Python。除非你在可信网络里,否则让
BLENDER_HOST保持为localhost。 - 遥测:默认会发送匿名的安装 ID、会话 ID、工具名称、是否成功、耗时、版本、操作系统和时间戳。提示词、生成的代码、截图和场景数据只有在你选择加入时才会发送,而选择加入的数据可能被用来训练 AI 模型。设置
DISABLE_TELEMETRY=true可完全关闭。 - 第三方密钥:3D 生成和部分素材来源使用以环境变量传入的 API key(例如
BLENDERMCP_MESHY_API_KEY)。Poly Pizza 的模型约 69% 是 CC-BY,所以需要署名,除非你只筛选 CC0。
用 Blender MCP,还是 Blender skill?
MCP 服务器给 agent 一条通向正在运行的 Blender 的实时连接。skill 给它某个工作流的书面说明和脚本,比如 EL4CTEO/blender-skills(28 个面向 Blender 5.2 LTS 及以上的工作流 skill,适用于 Claude Code、Codex 等)。两者配合得很好:skill 告诉 agent 怎么做出能直接用于游戏的素材,MCP 服务器让它在你打开的场景里完成。
我们在游戏开发 skills里列出了 Blender 和游戏制作的 skill 与 MCP 服务器,vibegamer.io 在游戏开发 agent skills里对它们做了对比。
Crewmark:和写代码的员工在同一块看板上的 3D 美术
Blender MCP 围绕一次一个会话设计:你下提示词,agent 建模,你来审查。如果你想要一个连续好几天不停做素材的 agent,同时其他 agent 在写游戏代码,Crewmark 是另一个选择。
在 Crewmark 里,每个 agent 是一名 AI 员工:一个有角色、长期运行的会话,运行在你自己的机器上。Claude Code 和 Codex 员工原生运行;其他 agent,比如 OpenCode、DeepSeek Harness 和 Gemini,通过 ACP(acpx)连接。工作在共享的 issue 看板上流转,你和员工们可以在上面分配 issue、评论、互相 @ 提及、修改状态。写代码的员工就是这样向 Blender 员工要一个新道具的:在 issue 上 @ 它。员工会按计划(心跳)以及被提及时醒来,所以工作不用你转交就会开始。
它不会取代 Blender MCP;装了这个服务器的员工照样用它。它加的是围绕它的角色、看板和唤醒机制。
常见问题
Blender MCP 免费吗?
免费。mcp-for-blender 是 MIT 协议的开源项目,它的网站说除 3D 生成外,所有功能在免费方案里都能用;3D 生成需要 Premium 方案(每月 10 美元起)或你自己的服务商 API key。Blender Lab 的服务器采用 GPL-3.0,免费。
Blender MCP 安全吗?
它会在 Blender 里运行 agent 写的任何 Python,而且它的套接字服务器没有认证。先保存你的工作,批准之前先读脚本,只在 localhost 上使用,并设置 BLENDER_MCP_SAFE_MODE=1 来阻止文件访问、其他程序和网络访问。设置 DISABLE_TELEMETRY=true 可关闭使用遥测。
有官方的 Blender MCP 服务器吗?
有。Blender Lab 在 projects.blender.org 发布了 blender_mcp(GPL-3.0,Blender 5.1+),并列在 Claude 的连接器目录里,作者标为 Blender Lab。流行的 mcp-for-blender 是第三方项目,与 Blender Foundation 无关联。
怎么把 Blender MCP 加到 Claude Code?
安装 uv,运行 claude mcp add blender uvx mcp-for-blender,用 claude mcp list 检查,然后用 uvx mcp-for-blender install-addon 安装并启用 Blender 插件。或者运行 README 里的一条命令安装器,它会帮你设置好 Claude Code。
怎么把 Blender MCP 加到 Codex?
运行 codex mcp add blender -- uvx mcp-for-blender,或者在 ~/.codex/config.toml 里添加 [mcp_servers.blender] 表,写上 command = "uvx" 和 args = ["mcp-for-blender"]。CLI、桌面应用和 IDE 扩展共用这个文件。README 还提供了一个 Codex 插件,能在聊天里显示实时视口。
我该用 Blender MCP 还是 Blender skill?
agent 需要操作正在运行的 Blender 场景时用 MCP;想给它一个经过验证的工作流去遵循时用 skill。很多配置两者都用:skill 描述工作流,MCP 服务器负责执行。
命令和功能已于 2026 年 11 月 21 日对照 mcp-for-blender 的 README、Blender Lab 的 blender_mcp 仓库和 wiki、Claude Code 和 Codex 的 MCP 文档,以及 Blender 的 glTF 导出文档核对。我们没有运行安装命令。