codex blender MCP

搅拌机Codex MCP

Codex MCP服务器有两种执行模式：

• addon 模式（默认）：通过Blender插件实时控制当前打开的Blender UI场景。
• subprocess 模式：无头每次调用Blender运行（传统行为）。

文件夹布局

• blender_codex_mcp/：Python MCP服务器包
• blender_addon/__init__.py：可安装的Blender插件入口文件

1） 安装MCP包

cd codex_mcp
pip install -e .

2） 安装Blender插件（实时模式）

1. 从以下位置创建zip文件 blender_addon 目录内容：

cd codex_mcp
Compress-Archive -Path blender_addon\* -DestinationPath codex_blender_mcp_addon.zip -Force

1. 在Blender中： Edit > Preferences > Add-ons > Install...
2. 选择 codex_blender_mcp_addon.zip.
3. 启用插件： Codex Blender MCP Bridge.
4. 打开 3D View > Sidebar > Codex MCP 选项卡。
5. 设置主机/端口(127.0.0.1:9877)并按 Start.

3） 将MCP服务器配置为插件模式

环境变量：

• BLENDER_MCP_MODE=addon
• BLENDER_ADDON_HOST=127.0.0.1
• BLENDER_ADDON_PORT=9877
• BLENDER_TIMEOUT_SECONDS=60

Codex MCP配置示例：

{
  "mcpServers": {
    "blender": {
      "command": "python",
      "args": ["-m", "blender_codex_mcp.server"],
      "env": {
        "BLENDER_MCP_MODE": "addon",
        "BLENDER_ADDON_HOST": "127.0.0.1",
        "BLENDER_ADDON_PORT": "9877",
        "BLENDER_TIMEOUT_SECONDS": "60"
      }
    }
  }
}

4） 实时工作流

1. 正常打开Blender UI并加载您的 .blend.
2. 从Blender面板启动插件服务器(Start 按钮）。
3. 启动Codex MCP服务器。
4. 呼叫工具(blender_add_primitive, blender_exec_python, blender_scene_info).
5. 更改将立即显示在当前Blender视口中。

用于验证的视口图像

使用MCP工具：

• blender_capture_viewport(save_path)

这捕获了活动 VIEW_3D 视口并保存PNG，以便Codex可以检查设计进度并建议下一步更改。

子进程模式（可选）

设置：

• BLENDER_MCP_MODE=subprocess
• BLENDER_PATH=C:\Program Files\Blender Foundation\Blender 5.0\blender.exe

此模式不提供实时视口更新。