用自然语言描述一个 3D 场景然后看着 Blender 自动创建出来——这不是科幻是 blender-mcp 现在能做到的事。blender-mcp 是一个开源 MCPModel Context Protocol服务器把 Blender 暴露给 AI 工具让任何支持 MCP 的 AI 工具包括 Codex都能直接操控 Blender 的场景、对象、材质、灯光和摄像机。项目地址ahujasid/blender-mcp24,500 stars。官方文档主要介绍的是 Claude 接入方式Codex 的接入方法略有不同而且有一个非常容易踩的配置坑本文重点讲这部分。需要准备什么Blender3.0 或更新版本Codex CLI已安装并登录uv / uvxblender-mcp 通过 uvx 启动不要用 pip installPython 3.10安装 uv选对应平台# macOSbrewinstalluv# Linuxcurl-LsSfhttps://astral.sh/uv/install.sh|sh# Windows PowerShellpowershell-cirm https://astral.sh/uv/install.ps1 | iex⚠️ 不要用pip install uv这不会创建uvx命令MCP 启动时会报spawn uvx ENOENT。Step 1在 Blender 里安装 addonblender-mcp 由两部分组成Blender 内运行的 addon和 AI 工具通过 MCP 协议连接的 Python 服务器。前往github.com/ahujasid/blender-mcp→ Releases → 下载最新的addon.py打开 Blender →Edit → Preferences → Add-ons点击Install…→ 选择刚下载的addon.py在 Add-ons 列表里找到Interface: Blender MCP→ 勾选启用安装完成后在 3D 视图里按N键打开侧边栏你会看到一个新的BlenderMCP标签。Step 2在 Codex 里配置 blender-mcp方式 A命令行一键添加推荐codex mcpaddblender -- 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 reportissue #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启动连接启动 CodexCLI 或桌面端切到 Blender在侧边栏BlenderMCP标签里点击Connect to Claude这个按钮在各种 AI 工具接入时都叫这个名字等待连接建立——Blender 状态栏底部会显示连接状态连接建立后Codex 里的工具列表/mcp应该能看到 blender 服务器下的具体工具比如get_scene_info、create_object、execute_blender_code等。其他常见问题spawn uvx ENOENT错误发生原因Codex 桌面端从 GUI 启动时不继承终端的 PATH找不到 uvx 的位置。解决方法用 uvx 的完整路径# 查找完整路径whichuvx# 通常是 /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 Haven 资产通过 API 搜索和导入模型、材质、HDRIHyper3D 生成用文字描述生成 3D 模型示例对话向 Codex 发出查看当前 Blender 场景里有哪些对象然后帮我把所有灯光的强度调高 50%创建一个低多边形风格的城堡场景包含塔楼、城墙和护城河把选中对象的材质改成金属质感粗糙度 0.2添加轻微反射附Blender 官方 MCP vs blender-mcpBlender 官方也在 2026 年 Q1 推出了自己的 MCP 服务器projects.blender.org/lab/blender_mcp定位是提供 Blender Python API 的自然语言接口侧重文档查询和 API 探索。两者定位不同官方 MCP 更适合我想了解某个 Blender API 怎么用的文档辅助场景ahujasid/blender-mcp更适合我想让 AI 直接操控场景的创作场景。结语整个接入流程不复杂唯一需要特别注意的是mcp_servers的拼写——这是绝大多数人配置失败的唯一原因。配置对了之后Codex 操控 Blender 的体验非常流畅特别是批量修改对象属性和执行复杂 Python 脚本这类任务。本文基于 blender-mcp 官方 README 和 Codex 官方 MCP 配置文档learn.chatgpt.com/docs/extend/mcp。参考资料blender-mcp GitHubgithub.com/ahujasid/blender-mcpblender-mcp 官网blendermcp.orgCodex MCP 官方文档learn.chatgpt.com/docs/extend/mcpCodex 编程接入qiniu.com/ai/planBlender 官方 MCPblender.org/lab/mcp-server