博客 · 编程 agent

Blender MCP:在 Claude Code 和 Codex 中安装

Blender MCP 是一个 MCP 服务器加一个 Blender 插件,让 Claude Code 或 Codex 这样的 AI agent 控制正在运行的 Blender,主要做法是在你打开的文件里编写并运行 Blender Python。这个名字通常指 mcp-for-blender,由 Siddharth Ahuja 做的社区项目(原名 blender-mcp);Blender 项目旗下的 Blender Lab 也发布了一个更小的官方服务器。这篇指南讲两者的区别,给出 Claude Code 和 Codex 的安装命令,用一个简短示例演示 agent 如何做出低多边形道具并导出 GLB,还会说明在让它运行之前该锁定哪些设置。更新于 2026 年 11 月 21 日。

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 项目的一部分
许可证MITGPL-3.0
Blender 版本3.0 或更高5.1 或更高
Star 数GitHub 上 35,153projects.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 文档;我们没有运行过。

  1. 安装 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
  2. 注册服务器

    这会把服务器保存到当前项目。加上 --scope user 就能在所有地方使用;这类选项要放在 -- 之前,-- 用来把它们和服务器命令隔开,这是 Claude Code 文档用的写法。在会话里,/mcp 会显示同样的状态。

    # README 里的命令
    claude mcp add blender uvx mcp-for-blender
    
    # 检查:应显示服务器已连接
    claude mcp list
    claude mcp get blender
  3. 可选:关闭遥测

    README 说,在服务器的环境变量里设置 DISABLE_TELEMETRY=true 即可彻底关闭遥测。Claude Code 的 claude mcp add 用 --env 传入环境变量;具体写法见 Claude Code MCP 文档。

  4. 安装并启用 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 的步骤相同。

  1. 用 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
  2. 或者编辑 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"]
  3. 可选: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 指南。

  1. 保存你的 .blend 文件

    agent 会直接编辑你打开的文件。README 的警告是:使用 execute_blender_code 之前,务必先保存你的工作。

  2. 给 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。
    每个脚本运行前先给我看。
  3. 在导出脚本运行前先读一遍

    导出通常以类似下面的调用收尾,用的是 Blender export_scene API 的参数。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 导出文档核对。我们没有运行安装命令。

给你的游戏配一个和程序员协作的 3D 美术。

Crewmark 给每个 agent 一个角色、一块共享的 issue 看板和定时唤醒,它们之间交接工作,不用你在终端之间复制粘贴。

Crewmark 是开源的:去 GitHub 点个 Star