用自然语言描述一个3D场景，然后看着Blender自动创建出来——这听起来像是科幻电影里的桥段，但blender-mcp现在确实做到了。它是一个开源MCP服务器，把Blender的创作能力直接暴露给AI工具，任何支持MCP的AI（包括Codex）都能直接操控场景、对象、材质、灯光和摄像机。

项目地址是ahujasid/blender-mcp，已经有24,500+ stars。官方文档主要介绍的是Claude的接入方式，但Codex的接入方法略有不同，而且有一个非常容易踩的配置坑——本文就重点讲这个部分。

---

需要准备什么

• Blender：3.0或更新版本
• Codex CLI：已安装并登录
• uv / uvx：blender-mcp通过uvx启动（不要用pip install）
• Python 3.10+

安装uv（选对应平台）：

# macOS
brew install uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

?? 千万别用pip install uv，这不会生成uvx命令，MCP启动时会报spawn uvx ENOENT错误。

---

Step 1：在Blender里安装addon

blender-mcp由两部分组成：一个在Blender内运行的addon，和一个通过MCP协议连接的Python服务器。

1. 前往github.com/ahujasid/blender-mcp → Releases → 下载最新的addon.py
2. 打开Blender → Edit → Preferences → Add-ons
3. 点击Install... → 选择刚下载的addon.py
4. 在Add-ons列表里找到Interface: Blender MCP → 勾选启用

安装完成后，在3D视图里按N键打开侧边栏，你会看到一个崭新的BlenderMCP标签。

---

Step 2：在Codex里配置blender-mcp

方式A：命令行一键添加（推荐）

codex mcp add blender -- uvx blender-mcp

这条命令会自动把配置写入~/.codex/config.toml，不用手动编辑。

方式B：手动编辑config.toml

打开~/.codex/config.toml，添加：

[mcp_servers.blender]
command = "uvx"
args = ["blender-mcp"]

---

最容易踩的坑：mcp_servers和mcp.servers不一样

Codex的GitHub issue tracker上有一个高赞bug报告（issue #3441）：用户配置了MCP服务器但Codex完全看不到它，怎么折腾都没用。

原因就一个：把[mcp_servers.blender]写成了[mcp.servers.blender]（或[mcp.servers."blender"]）。

正确写法：

[mcp_servers.blender]
command = "uvx"
args = ["blender-mcp"]

错误写法（MCP完全不加载）：

[mcp.servers.blender]          # ? 错了
command = "uvx"
args = ["blender-mcp"]

两者的格式几乎一模一样，但Codex只认mcp_servers，用mcp.servers会导致整个MCP配置被静默忽略。

验证MCP是否加载成功：启动Codex后在TUI里输入/mcp，应该能看到blender服务器和它提供的工具列表。

---

Step 3：启动连接

1. 启动Codex（CLI或桌面端）
2. 切换到Blender，在侧边栏BlenderMCP标签里点击Connect to Claude（这个按钮在各种AI工具接入时都叫这个名字）
3. 等待连接建立——Blender状态栏底部会显示连接状态

连接建立后，Codex里的工具列表（/mcp）应该能看到blender服务器下的具体工具，比如get_scene_info、create_object、execute_blender_code等。

---

其他常见问题

spawn uvx ENOENT错误

发生原因：Codex桌面端从GUI启动时不继承终端的PATH，找不到uvx的位置。

解决方法：用uvx的完整路径：

# 查找完整路径
which uvx
# 通常是 /opt/homebrew/bin/uvx (macOS) 或 ~/.local/bin/uvx (Linux)

然后在config.toml里用完整路径：

[mcp_servers.blender]
command = "/opt/homebrew/bin/uvx"
args = ["blender-mcp"]

项目级config不生效

在项目目录下创建.codex/config.toml配置MCP时，需要先把该目录加入Codex的受信任目录列表（在~/.codex/config.toml里），否则项目级MCP配置会被忽略。

首次连接超时

uvx首次运行会下载blender-mcp包，耗时较长。可以增加启动超时：

[mcp_servers.blender]
command = "uvx"
args = ["blender-mcp"]
startup_timeout_sec = 30

不要同时开两个MCP实例

blender-mcp README明确警告：不要在Codex和Claude Desktop（或其他工具）里同时运行blender-mcp服务器，会产生冲突。同一时间只开一个。

---

连接成功后能做什么

blender-mcp暴露的能力包括：

• 场景信息：获取当前场景的对象列表、层次结构、材质状态
• 对象操作：创建、移动、缩放、旋转、删除3D对象
• 材质控制：应用颜色、创建材质、修改PBR参数
• 灯光与摄像机：调整光源参数、设置摄像机角度和焦距
• 执行Python代码：直接在Blender里运行任意Python脚本（强大但需谨慎）
• Poly Ha ven资产：通过API搜索和导入模型、材质、HDRI
• Hyper3D生成：用文字描述生成3D模型

示例对话（向Codex发出）：

• 查看当前Blender场景里有哪些对象，然后帮我把所有灯光的强度调高50%
• 创建一个低多边形风格的城堡场景，包含塔楼、城墙和护城河
• 把选中对象的材质改成金属质感，粗糙度0.2，添加轻微反射

---

附：Blender官方MCP vs blender-mcp

Blender官方也在2026年Q1推出了自己的MCP服务器，定位是提供Blender Python API的自然语言接口，侧重文档查询和API探索。

两者定位不同：官方MCP更适合“我想了解某个Blender API怎么用”的文档辅助场景；ahujasid/blender-mcp更适合“我想让AI直接操控场景”的创作场景。

---

结语

整个接入流程并不复杂，唯一需要特别注意的就是mcp_servers的拼写——这几乎是绝大多数人配置失败的唯一原因。配置对了之后，Codex操控Blender的体验非常流畅，尤其是批量修改对象属性和执行复杂Python脚本这类任务。