用途:让 AI 客户端(Claude Desktop、Cursor、VS Code、Codex、OpenCode)通过 MCP 驱动 Blender,进行场景检查、建模、材质、渲染、导入导出等操作。它由两半组成,必须同时运行:AI 客户端连接 blender-mcp 服务器进程(uvx blender-mcp),服务器经 127.0.0.1:9876 本地套接字,连接运行中 Blender 内的插件,由插件执行命令。
主要能力:服务器暴露 31 个 MCP 工具和 1 个提示;支持多 Blender 实例(各用不同端口);可导出 GLB 或 FBX;可接入 Poly Haven、Poly Pizza、Sketchfab、Hyper3D Rodin、Hunyuan3D 等素材或文本转 3D 来源。
使用方式:先用官方安装器装 uv(不要 pip install uv),运行 uvx blender-mcp 启动服务器,uvx blender-mcp install-addon 把插件复制到 Blender 插件目录,然后在 Blender 偏好设置启用插件并从侧边栏启动。客户端配置以子进程方式运行服务器,可指定 --python 3.11 与 UV_PYTHON_PREFERENCE=only-managed;GUI 客户端可能找不到 PATH,需用 uvx 绝对路径。连接优先级为 CLI 标志、环境变量、默认 localhost:9876。
限制:execute_blender_code 在用户 Blender 进程内运行任意 Python,默认不校验;建议开启 BLENDER_MCP_SAFE_MODE=1(AST 允许列表,仍非沙箱)。套接字无认证和加密,仅限 localhost,远程须用 SSH 隧道。遥测默认开启且收集范围较广,处理机密工作前应关闭。素材描述属不可信第三方文本。export_scene 写入绝对路径并默认烘焙修改器,对绑定或形态键网格不合适。检查器可用 python3 .agent-skills/blender-mcp/scripts/blender-mcp-check.py doctor 与 posture。