AI导哈

Blender MCP服务器

Blender Codex MCP是一个用于实时控制Blender UI场景或通过子进程模式运行Blender的服务器工具。

  • by hassledzebra
  • Python
  • 本地部署
  • 25 星标
  • 更新于
在 GitHub 查看 hassledzebra/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

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

相关 MCP