SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台blender-mcp

blender-mcp

本项目（原名为 blender-mcp，现 PyPI 包名为 mcp-for-blender）是一个社区插件，用于将 Blender 3D 与任意 LLM 连接，实现由 AI 驱动的提示辅助三维建模、场景创建与操作。它并非 Blender 官方基金会出品，属于第三方集成。系统由两部分组成：Blender 插件（addon.py）在 Blender 内创建套接字服务器以接收并执行命令；MCP 服务器（src/blender_mcp/server.py）实现模型上下文协议并连接该插件。项目提供一键安装脚本，可自动安装 uv、配置检测到的 MCP 客户端（如 Claude Desktop、Claude Code、Codex、Cursor、VS Code、Windsurf、OpenCode、Antigravity）并安装启用 Blender 插件。使用时需在 Blender 侧边栏启动 MCP 服务器并连接，随后即可通过自然语言让 AI 完成建模、布局、材质、动画、绑定与重拓扑等任务；服务器本身不直接修改 Blender 插件文件，启动时会检测版本落后并记录更新方式。需注意套接字服务器无认证与加密，建议仅在本地使用；可启用安全模式阻止高风险脚本。

访问官网

工具介绍

MCP for Blender（原 blender-mcp）是一个社区维护的第三方集成，用于将 Blender 3D 连接到任意 LLM，实现提示辅助的三维建模、场景创建与操作。它并非 Blender 官方基金会出品。

用途 通过 AI 驱动 Blender 完成建模、布局、材质、动画、绑定和重拓扑等工作。AI 自行编写 Blender Python 脚本，MCP 则提供 Python 本身无法完成的能力，共包含九个工具。

主要能力

  • Blender 插件（addon.py）在 Blender 内创建套接字服务器，接收并执行来自 MCP 服务器的命令。
  • MCP 服务器（src/blender_mcp/server.py）实现 Model Context Protocol 并连接 Blender 插件。
  • 通过一个命令即可设置 AI 应用与 Blender 插件：自动安装 uv（如需要），检测本机上的 MCP 客户端（Claude Desktop、Claude Code、Codex、Cursor、VS Code、Devin Desktop/Windsurf、OpenCode、Antigravity），让用户选择要设置哪些，然后安装并启用 Blender 插件。已有配置仅新增一个 blender 条目，并为每个修改的文件保存 .bak 备份。（Windows 使用 PowerShell 安装；已安装 uv 可用 uvx mcp-for-blender setup。）
  • 支持将 Hunyuan3D、Tripo、Hyper3D Rodin 生成的 AI 三维模型直接导入 Blender，无需自带 API 密钥。使用腾讯云官方 API 时，需根据账号所在区域选择对应服务；国际版凭据发送到大陆端点会报 AuthFailure.SignatureFailure 或 ResourceUnavailable，此时需勾选侧边栏 Tencent Hunyuan 3D → Official API 下的切换开关。
  • Poly Haven 集成：约 2400 个 HDRIs、纹理与模型，全部 CC0 免费，无需 API 密钥、账号，无需要担心的速率限制。在 3D 视图侧边栏勾选 Poly Haven 即可。示例："用阴天午后 HDRI 照亮场景，并在墙上贴生锈金属纹理"，AI 会调用 search_assets(source="polyhaven", query="overcast afternoon", asset_type="hdris")；previews=3 会在消耗带宽前附上顶部结果缩略图；import_asset(source="polyhaven", id="...", asset_type="textures", apply_to=["Wall"]) 可一次调用下载纹理并应用。搜索还可按类别路径或属性过滤，如 HDRIs 的天气与时段、纹理的表面用途与状况；未知属性会返回有效属性错误。模型从 .bl 文件导入。
  • Codex 插件提供聊天内嵌实时视口（点击对象可附加到下一条消息）、Poly Haven、Sketchfab、Poly Pizza 缩略图选择器，以及对场景对象、材质和集合的 @ 提及。

使用方式 前置条件：Blender 3.0 或更新版本、Python 3.10 或更新版本、uv 包管理器。

  1. 安装 uv（官方安装器，不要使用 pip install uv）。
  2. 将 MCP 服务器添加到客户端（各客户端配置说明见仓库：Claude for Desktop、Claude Code、Codex、Cursor、Visual Studio Code、OpenCode、Antigravity）。
  3. 安装 Blender 插件：在 Blender 中 Edit → Preferences → Add-ons → 启用 Interface: MCP for Blender。插件在 Blender 打开时启动其服务器。可在 3D 视口按 N 打开 MCP for Blender 标签页检查（若未运行，点击 Start MCP Server）。 连接：在 Blender 中打开 3D 视图侧边栏（按 N），找到 MCP for Blender 标签页，勾选所需选项，点击 Connect to Claude，并确保终端中 MCP 服务器正在运行。连接后 Claude 中会显示带工具的锤子图标。 一键安装：Windows（PowerShell）；已安装 uv 时使用 uvx mcp-for-blender setup。随后完全退出并重启 AI 应用（Windows 需从系统托盘退出），打开 Blender 并让它构建内容。 环境变量：可配置 Blender 连接；也可通过 CLI 标志传递，优先级高于环境变量，便于并排运行多个 Blender 实例（每个实例需在 Blender 插件面板设置自己的端口以匹配）。 Docker：可在容器中运行 MCP 服务器，Blender 本身仍在主机运行。镜像默认 BLENDER_HOST=host.docker.internal；Linux 下需改用 host 网络。容器中启用安全模式可添加 "-e", "BLENDER_MCP_SAFE_MODE=1"。 安全模式：默认 AI 可在 Blender 中运行任意 Python 代码。设置 BLENDER_MCP_SAFE_MODE=1 可在每次脚本运行前检查并阻止高风险代码（如直接读写文件、运行其他程序、访问网络、安装持续运行的代码）。正常 Blender 工作（建模、材质、渲染、保存、导入导出）仍可进行；被阻止的脚本会连同原因返回给 AI，以便其修正后重试。 路径问题：从 GUI 启动的 MCP 客户端不继承终端 PATH，直接写 "command": "uvx" 可能报 spawn uvx ENOENT；可改用 uvx 完整路径，或在 Windows 上包装为 "command": "cmd", "args": ["/c", "uvx", "mcp-for-blender"]。更改后需完全退出并重启客户端。 Python 版本：uv 决定运行服务器的 Python。存在 conda/pyenv/asdf 或较新 CPython 时可固定 Python 3.11 并优先使用 uv 托管解释器（UV_PYTHON_PREFERENCE=only-managed）。缓存清理可解决失败重试问题。受限机器可用 pipx 安装后指向命令。 升级：更新 MCP 服务器与所有已安装的 Blender 插件副本，并保留 .bak；不会降级比发布版更新的插件，也不改动本地已编辑的副本；可加 --dry-run 预览。首次使用 @latest（早于 2.1.7 的版本没有 update 命令）。更新后重启 MCP 客户端，并在 Blender 中重启或禁用再启用插件，再点击 Start MCP Server。

适用场景 适合希望在 Blender 内利用任意 LLM 进行提示辅助建模、场景搭建、材质与资产搜寻、动画与绑定等工作的用户，也适合需要将 AI 三维模型生成服务接入 Blender 的工作流。

限制与注意事项

  • 这是第三方集成，非 Blender 官方制作。
  • 插件套接字服务器无认证或加密，能访问该端口的人即可在 Blender 内运行 Python。除非处于可信网络，否则应保持在 localhost；不建议将 --host / BLENDER_HOST 直接指向远程机器，优先使用 SSH 隧道。
  • 一次只应运行一个 MCP 服务器实例（Cursor 或 Claude Desktop 二选一，不要同时运行）。
  • 默认 AI 可执行任意 Python，需通过 BLENDER_MCP_SAFE_MODE=1 启用安全模式。
  • 其他具体功能、收费与价格信息暂未提供。

同类工具

查看分类