Blender MCP Server已精选

什么是 Blender MCP Server？

Blender MCP（现名 MCP for Blender）是一个开源服务器，通过 Model Context Protocol 把 Blender 连接到 Claude 及其他 LLM，让 AI 可以根据聊天提示，在你正在运行的 Blender 中创建、查看和修改 3D 场景。

该项目由 GitHub 用户 ahujasid 维护，是第三方集成，并非 Blender 基金会出品。它由两部分组成：在 Blender 内部开启本地 socket 服务器的 Blender 插件，以及把客户端命令转发给插件的 Python MCP 服务器。PyPI 包已从 blender-mcp 更名为 mcp-for-blender，仓库也迁移到了 ahujasid/mcp-for-blender；现有的 uvx blender-mcp 配置仍可继续使用。

如何使用 Blender MCP Server？

前置条件：Blender 3.0+、Python 3.10+，以及 uv 包管理器。请使用 uv 的官方安装程序安装，而不是 pip install uv。

一行安装脚本会在需要时安装 uv，配置它检测到的 MCP 客户端（Claude Desktop、Claude Code、Codex、Cursor、VS Code、Windsurf 等），然后安装并启用 Blender 插件：

# macOS / Linux
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"

如果已经安装了 uv，可以改为运行 uvx mcp-for-blender setup。如果只想安装插件，运行 uvx mcp-for-blender install-addon，然后在 Edit > Preferences > Add-ons 中启用 Interface: MCP for Blender。

Claude Desktop

Claude > Settings > Developer > Edit Config：

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["mcp-for-blender"]
    }
  }
}

Claude Code

claude mcp add blender uvx mcp-for-blender

Cursor

在 Settings > MCP 中添加与上面相同的 mcpServers JSON，或者为单个项目写入 .cursor/mcp.json。在 Windows 上，使用 "command": "cmd" 并设置 "args": ["/c", "uvx", "mcp-for-blender"]。

VS Code

使用 README 中的 “Install in VS Code” 按钮，或注册一个 stdio 服务器，命令为 uvx，参数为 mcp-for-blender。

Codex

codex mcp add blender -- uvx mcp-for-blender

然后打开 Blender，在 3D 视口中按 N，打开 MCP for Blender 标签页；如果服务器尚未运行，点击 Start MCP Server。修改 AI 应用的配置后，请完全退出并重新打开该应用。

Blender MCP Server 的主要功能

• AI 客户端与 Blender 通过本地 socket（默认 localhost:9876）双向通信。
• 对象操作：创建、修改和删除对象，应用或更改材质与颜色。
• 视觉校验：视口、相机、多角度、线框、X 光和动画条视图，以及渲染结果，让 AI 能检查自己的工作。
• 在正在运行的 Blender 会话中执行 Python 代码。
• 从 Poly Haven（CC0，无需密钥）、Sketchfab 和 Poly Pizza（二者都需要 API 密钥）搜索并导入素材。
• 通过 Hyper3D Rodin、Hunyuan3D 或 Tripo 进行 AI 3D 模型生成，可使用你自己的密钥或可选的付费 Premium 服务。
• 可选的安全模式（BLENDER_MCP_SAFE_MODE=1），会检查脚本并拦截文件、网络或进程访问等高风险操作。

Blender MCP Server 工具

当前版本把功能归并为九个工具：

• 场景控制：execute_blender_code 在 Blender 中运行 Python；get_scene_info 按对象返回简洁的场景摘要。
• 视觉反馈：look 从视口、相机、自动取景的多角度或动画帧展示结果，支持 solid、material、rendered、wireframe 或 X 光着色。
• 素材：search_assets 和 import_asset 覆盖 Poly Haven 的 HDRI、纹理和模型，Sketchfab 模型以及 Poly Pizza 低多边形模型。
• 生成：generate_3d 一次调用即可用 Tripo、Hunyuan3D 或 Hyper3D Rodin 生成并导入模型。
• 状态与数据控制：get_addon_status 报告 Blender 与插件版本以及已启用的集成；disable_telemetry 和 record_trajectory_feedback 控制数据收集。

旧版本提供的是 get_viewport_screenshot、search_polyhaven_assets 等独立工具，因此基于旧版本整理的工具列表可能与此不同。

Blender MCP Server 的使用场景

• 用一句提示搭建场景：“Create a low poly scene in a dungeon, with a dragon guarding a pot of gold.”
• 设置灯光和材质：“用阴天午后的 HDRI 照亮场景，并给墙面加上生锈金属纹理。”
• 把参考图转成 Blender 场景，或生成单个素材：“通过 Hyper3D 生成一个花园地精的 3D 模型。”
• 用风格化素材布置关卡：“用 Poly Pizza 的低多边形家具把这个房间填满。”
• 快速调整外观：“把这辆车改成红色金属质感”，或“把相机对准场景并改成等轴视图”。
• 查看场景并导出结构：“获取当前场景信息，并据此做一个 threejs 草图。”

Blender MCP Server 与替代方案对比

Blender MCP 操控的是完整的 Blender 应用，包括它的 Python API、渲染以及外部素材库。如果面向游戏引擎，可以看看 Unity MCP Server 或 Godot MCP Server；如果在 Blockbench 中做低多边形建模，可参考 Blockbench MCP plugin。Blender 官方并未提供 MCP 服务器；这个社区项目在 GitHub 上有超过 30,000 颗星，是最受欢迎的选择。

Blender MCP Server 常见问题排查

• spawn uvx ENOENT：图形界面客户端可能不会继承终端的 PATH。把 which uvx（Windows 上为 where uvx）得到的完整路径填为 command，然后完全重启客户端。
• 连接问题：确认 Blender 中的插件服务器正在运行，并且客户端中已配置 MCP 服务器。不要同时在终端里手动运行 uvx 命令，且只运行一个客户端实例（例如 Cursor 或 Claude Desktop，不要两者同时）。
• 因 conda 或 pyenv 导致安装失败：用 "args": ["--python", "3.11", "mcp-for-blender"] 固定 Python 版本，并设置 UV_PYTHON_PREFERENCE=only-managed；用 uv cache clean mcp-for-blender blender-mcp 清理过期缓存。
• 超时：简化请求，或拆分成更小的步骤。
• 下载 Poly Haven 素材时 Blender 卡住：下载在 Blender 主线程中进行，除非素材离相机很近，否则请选择 1k 或 2k 分辨率。