Codex 接入 MCP for Blender 教程：用自然语言控制 Blender 的完整配置方法
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本身支持 MCPModel 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-mcpMCP Server → Blender 插件 → Blender 场景所以配置分两侧Codex 侧注册 MCP ServerBlender 侧装插件并启动服务。二、准备工作开始之前确认以下环境项目要求Blender3.0 或更新版本Python3.10 或更新版本uv 包管理器提供uvx命令Codex CLI已安装并完成登录Node.js18npm 方式安装 Codex 时需要如果还没装 Codex CLI用 npm 全局安装npmi-gopenai/codex安装后执行codex --version确认版本首次使用需要codex login登录 ChatGPT 账号或配置 API Key。三、安装 uv 包管理器blender-mcp 这个 MCP Server 通过uvx命令启动所以先装 uv。注意不要用pip install uv安装官方明确提示这种方式可能有兼容问题要用官方安装脚本。Windows 下用 PowerShell 执行powershell-ExecutionPolicy ByPass-cirm https://astral.sh/uv/install.ps1 | iexmacOS / Linux 下执行curl-LsSfhttps://astral.sh/uv/install.sh|sh安装完成后重新打开一个终端执行uv --version能正常输出版本号即可。四、在 Codex 中注册 blender-mcpCodex CLI 的 MCP 配置写在~/.codex/config.tomlWindows 下是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 uvxWindows或which uvxmacOS/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-addon2. 在 Blender 中启用插件打开 Blender依次操作进入Edit → Preferences → Add-ons搜索Interface: Blender MCP勾选复选框启用。六、启动 Blender 内的 MCP 服务插件启用后回到 Blender 的 3D 视口按N键打开侧边栏切换到BlenderMCP标签页点击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 cubeBlender 视口里出现了球体说明 Codex → blender-mcp → Blender 的整条链路通了。然后再试官方给的复杂场景指令Create a low poly dungeon scene with a dragon guarding a pot of goldCreate a beach scene using HDRIs, textures, and vegetation from Poly HavenAI 会把描述拆解成一系列 Blender 命令场景实时生成。安全提醒blender-mcp 提供的execute_blender_code工具可以在 Blender 内执行任意 Python 代码。让 AI 操作之前尤其是复杂场景下先保存你的 Blender 工程文件避免误操作丢失工作成果。八、常见问题1. codex mcp list 里看不到 blender或 Codex 说找不到 uvx多为 PATH 问题。用where uvxWindows或which uvxmacOS/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 安装 uvMCP 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/quickstartMCP for Blender MCP Clients https://mcp-for-blender.com/mcp-clients