企业官网建设流程全解析

Codex 接入 MCP for Blender 教程：用AI控制 Blender 的完整配置方法

关键词：Codex、Codex MCP、MCP for Blender、blender-mcp、Codex CLI、config.toml、uvx、Blender 插件、3D 场景生成

摘要

本文分享 Codex CLI 接入 MCP for Blender 的完整流程：安装 uv 包管理器、在 Codex 的config.toml中注册 blender-mcp MCP 服务、安装并启用 Blender 插件、启动 Blender 内的 MCP 服务，最后用一句自然语言让 Codex 驱动 Blender 生成 3D 场景。照着步骤操作即可跑通。

正文

大家好 这里是「代码简单说」，这篇文章主要分享一下 Codex 接入 MCP for Blender 的配置方法。

Codex CLI 是 OpenAI 的终端编码 Agent，本身支持 MCP（Model Context Protocol）协议，可以调用外部 MCP Server 提供的工具。MCP for Blender 则是让 AI 客户端控制 Blender 的 MCP 方案。两者接起来之后，你可以直接在 Codex 里输入「创建一个球体，放在立方体上方」，Codex 会调用 blender-mcp 提供的工具，在 Blender 里实时完成建模。

需要说明一点：MCP for Blender 官方的客户端列表里直接给出的是 Claude Desktop、Claude Code、Cursor、VS Code、OpenCode、Antigravity 这些客户端，没有单独列 Codex。但 Codex CLI 原生支持 stdio 类型的 MCP Server，配置方式是通用的，按照本文的步骤即可接入。

一、整体接入思路

MCP for Blender 由两部分组成：

• MCP Server：通过uvx blender-mcp启动，负责在 AI 客户端和 Blender 之间转发指令；
• Blender 插件：装在 Blender 内部，负责接收指令并在 Blender 里执行。

Codex 作为 MCP Client，负责调用 MCP Server。整体链路是：

Codex CLI → blender-mcp（MCP Server） → Blender 插件 → Blender 场景

所以配置分两侧：Codex 侧注册 MCP Server，Blender 侧装插件并启动服务。

二、准备工作

开始之前，确认以下环境：

如果还没装 Codex CLI，用 npm 全局安装：

npmi-g@openai/codex

安装后执行codex --version确认版本，首次使用需要codex login登录 ChatGPT 账号或配置 API Key。

三、安装 uv 包管理器

blender-mcp 这个 MCP Server 通过uvx命令启动，所以先装 uv。

注意：不要用pip install uv安装，官方明确提示这种方式可能有兼容问题，要用官方安装脚本。

Windows 下用 PowerShell 执行：

powershell-ExecutionPolicy ByPass-c"irm https://astral.sh/uv/install.ps1 | iex"

macOS / Linux 下执行：

curl-LsSfhttps://astral.sh/uv/install.sh|sh

安装完成后重新打开一个终端，执行uv --version能正常输出版本号即可。

四、在 Codex 中注册 blender-mcp

Codex CLI 的 MCP 配置写在~/.codex/config.toml（Windows 下是C:\Users\你的用户名\.codex\config.toml），每个 MCP Server 占一个[mcp_servers.<名称>]配置段。有两种配置方式，选一种即可。

方式 1：用 codex mcp add 命令（推荐）

一条命令完成注册：

codex mcpaddblender -- uvx blender-mcp

命令执行后，Codex 会自动把[mcp_servers.blender]配置段写入config.toml，不用手动改文件。

方式 2：手动编辑 config.toml

打开~/.codex/config.toml，加入以下内容：

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

Windows 下找不到 uvx 的情况：如果 Codex 启动 MCP Server 时提示找不到uvx，先用where uvx（Windows）或which uvx（macOS/Linux）查到完整路径，把command改成完整路径：

[mcp_servers.blender] command = "C:\\Users\\你的用户名\\.local\\bin\\uvx.exe" args = ["blender-mcp"]

验证注册结果

codex mcp list

输出里能看到blender这一项，说明注册成功。也可以用codex mcp get blender查看具体配置。配置修改后，重启 Codex 生效。

五、安装并启用 Blender 插件

Codex 侧配置好后，轮到 Blender 侧。

1. 执行插件安装命令

在终端执行：

uvx blender-mcp install-addon

2. 在 Blender 中启用插件

打开 Blender，依次操作：

1. 进入Edit → Preferences → Add-ons；
2. 搜索Interface: Blender MCP；
3. 勾选复选框启用。

六、启动 Blender 内的 MCP 服务

插件启用后，回到 Blender 的 3D 视口：

1. 按N键打开侧边栏；
2. 切换到BlenderMCP标签页；
3. 点击Start MCP Server。

服务默认监听localhost:9876。如果端口有冲突，可以通过BLENDER_HOST和BLENDER_PORT两个环境变量覆盖默认值，Codex 的配置里也支持给 MCP Server 传环境变量：

[mcp_servers.blender] command = "uvx" args = ["blender-mcp"] env = { BLENDER_HOST = "localhost", BLENDER_PORT = "9876" }

重要限制：MCP 服务同一时间只能跑一个实例。不要同时让 Codex 和 Claude Desktop 之类的其他客户端连接 MCP for Blender，先在一个客户端用完再换另一个，否则会冲突。

七、验证与使用

全部配置完成后，在 Blender 里点击Start MCP Server，然后启动 Codex，直接输入自然语言指令测试。

先用简单指令验证链路：

Create a sphere and place it above the cube

Blender 视口里出现了球体，说明 Codex → blender-mcp → Blender 的整条链路通了。

然后再试官方给的复杂场景指令：

Create a low poly dungeon scene with a dragon guarding a pot of gold

Create a beach scene using HDRIs, textures, and vegetation from Poly Haven

AI 会把描述拆解成一系列 Blender 命令，场景实时生成。

安全提醒：blender-mcp 提供的execute_blender_code工具可以在 Blender 内执行任意 Python 代码。让 AI 操作之前，尤其是复杂场景下，先保存你的 Blender 工程文件，避免误操作丢失工作成果。

八、常见问题

1. codex mcp list 里看不到 blender，或 Codex 说找不到 uvx？

多为 PATH 问题。用where uvx（Windows）或which uvx（macOS/Linux）找到uvx的完整路径，把config.toml里command的值改成完整路径（Windows 路径注意用双反斜杠\\）。

2. Codex 调用工具失败或连接不上？

按顺序检查三点：Blender 插件是否已启用、Blender 里的 MCP 服务是否已点击Start MCP Server、config.toml里的端口和环境变量是否与 Blender 侧一致。修改配置后记得重启 Codex。

3. 能同时让 Codex 和 Claude Desktop 连接吗？

不行。MCP for Blender 的服务同一时间只允许一个实例连接，多个客户端同时连同一个服务会冲突，用完一个再换下一个。

4. 为什么不用 pip 安装 uv？

MCP for Blender 官方明确提示不要通过pip install uv安装，可能存在兼容问题，直接用本文第三节的官方安装脚本。

5. Blender 插件列表里搜不到 Interface: Blender MCP？

先确认执行过uvx blender-mcp install-addon，再确认 Blender 版本在 3.0 以上。刚执行完安装命令的话，重启一下 Blender 再搜。

6. AI 把场景改乱了怎么办？

execute_blender_code会在 Blender 里执行任意 Python 代码，操作前先保存工程文件。出问题后可以用撤销或重新打开文件恢复，复杂任务建议分步骤下指令，别一次让 AI 做太多。

九、总结

以上就是 Codex 接入 MCP for Blender 的完整教程，整体流程分三块：装 uv、在 Codex 的config.toml里注册[mcp_servers.blender]、在 Blender 侧装插件并启动服务。核心配置就一条命令：

codex mcpaddblender -- uvx blender-mcp

配置完成后用codex mcp list验证，Blender 里点Start MCP Server，就能用自然语言让 Codex 建 3D 场景了。如果遇到连接问题，先检查插件启用状态、服务启动状态、端口配置这三点。

参考文档：
MCP for Blender Quickstart https://mcp-for-blender.com/quickstart
MCP for Blender MCP Clients https://mcp-for-blender.com/mcp-clients