MCP for Blender：让任意LLM用自然语言操控Blender场景
一个让Claude等LLM用自然语言操控Blender的MCP插件，还能拉取资产和生成3D模型。
GitHub ahujasid/mcp-for-blender 更新 2026-09-30 分支 main 星标 29.7K 分叉 2.7K
Python MCP Blender Claude Hyper3D Rodin Hunyuan3D Docker

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你希望用Claude通过自然语言创建Blender物体、材质或完整场景。
    README 的 Features 和 Usage → Example Commands，列出了物体操作、材质控制及创建场景示例。
  • 你需要从Poly Haven、Sketchfab、Poly Pizza或Hyper3D Rodin获取3D资产。
    README 的 Features → Asset & model generation，明确列出这些资产来源。
  • 你的MCP客户端支持uvx，并能在Blender中安装Interface: MCP for Blender插件。
    README 的 Quickstart 要求安装uv、配置MCP客户端并安装Blender addon。
  • 你希望把MCP服务器放进Docker，而让本机继续运行Blender。
    README 的 Installation → Run with Docker 明确说明容器只托管MCP服务器，Blender仍运行在本机。

不适合，如果你

  • 你的环境不能安装uv、pipx或Docker，也不能手动安装Blender addon.py。
    README 只提供uv、pipx、Docker和手动选择addon.py这些安装路径。
  • 你的工作流不能接受Claude执行任意Python代码。
    README 的 Features → Code execution 明确写明可从Claude在Blender中运行arbitrary Python code。
  • 你必须让Blender在Poly Haven高分辨率下载时保持界面持续响应。
    README 的 Troubleshooting 说明Poly Haven资产在Blender主线程下载，传输期间UI会停止响应。
  • 你的Poly Pizza请求只能从数据中心、VPN或云端IP发出。
    README 的 Troubleshooting 说明static.poly.pizza的Cloudflare防护会阻止这些IP。

前置条件

  • 需要安装uv；README警告不要使用pip install uv，应使用官方安装器。
  • 需要配置一个MCP客户端，例如Claude Desktop、Claude Code或Codex。
  • 需要在Blender中启用Interface: MCP for Blender，并在3D视图按N打开MCP for Blender标签。
  • 连接时点击Start MCP Server；README要求只运行一个MCP服务器实例。
  • 使用Sketchfab、Poly Pizza、Hyper3D或Hunyuan3D时，需要对应API Key、SecretId/SecretKey或API URL。
  • Docker方案需要构建mcp-for-blender镜像；Linux还需要--network=host和BLENDER_HOST=localhost。

第一步命令（README 原文）

uvx mcp-for-blender install-addon

要注意

  • 新安装应使用mcp-for-blender，旧命令uvx blender-mcp仍可运行且无需改配置。
    README Quickstart 的包名迁移说明。
  • 不要在终端直接运行uvx命令排查连接问题。
    README Troubleshooting → Connection issues 明确写有Do not run the uvx command in the terminal。
  • Poly Haven分辨率每增加一级，文件大小约扩大四倍。
    README Troubleshooting → Blender freezes during a Poly Haven download。
  • Docker客户端参数必须包含-i，因为服务器通过stdin/stdout与客户端通信。
    README Installation → Run with Docker。
  • Claude Desktop和Cursor不能同时启动两个MCP服务器实例。
    README Quickstart → Connect 要求只运行一个MCP server实例。

替代方案

  • Blender Python API：需要完全确定性的脚本化建模流程，且不需要MCP客户端或LLM交互时更合适。
    通用领域知识
  • pipx安装mcp-for-blender：锁定环境无法使用uvx，但可以使用pipx时更合适。
    README Installation → Install without uv
  • Docker运行mcp-for-blender：希望隔离MCP服务器安装，并让Blender继续运行在宿主机时更合适。
    README Installation → Run with Docker

材料未说明

  • 材料未提供支持的Blender版本和操作系统完整矩阵。
  • 材料未说明各LLM客户端的兼容版本及除Claude、Codex、Cursor、VS Code之外的实际兼容范围。
  • 材料未说明任意Python代码执行的权限边界、隔离机制和默认安全模式行为。
  • 材料未提供Hyper3D、Hunyuan3D、Sketchfab和Poly Pizza的费用、配额及服务可用性。
  • 材料未提供性能基准，例如场景规模、模型生成耗时或并发限制。
  • 仓库当前无版本发布，材料未说明稳定版本策略；元数据显示贡献者10人、最近提交10条。
  • 材料未说明2026-09-30更新是否带来功能变化，也无法仅凭README解释当日Trending关注原因。

💡 深度解析

6
不适合 我已经在 Cursor 和 Claude Desktop 中都配置了 mcp-for-blender，想让两个客户端共同操作同一个 Blender 场景；这个项目支持同时运行吗？
适合读者： 同时使用 Cursor 和 Claude Desktop 的 Blender 自动化开发者，希望两个客户端共同控制同一个本地场景

不适合按这种方式同时运行，因为 README 明确要求一次只启动一个 MCP 服务器实例；两个客户端同时连接可能造成连接或状态冲突。

  • Quickstart 的 Connect 部分写明“Only run one instance of the MCP server (either Cursor or Claude Desktop), not both”。
  • 项目采用 socket-based server 与 Blender 插件双向通信，多个服务器实例并不是两个独立的安全会话。
  • Cursor 和 Claude Desktop 都属于受支持的 MCP 客户端，但“支持两个客户端”不等于“允许同时启动两个服务器实例”。
  • 如果你的流程必须在两个客户端间切换，README 没有说明场景锁、请求仲裁、会话隔离或状态恢复机制，因此不能把它当作双客户端并发控制方案。
  • README / Quickstart / Connect："Only run one instance of the MCP server (either Cursor or Claude Desktop), not both."
  • README / Features："Two-way communication ... through a socket-based server"
  • README / Quickstart：Cursor / VS Code / OpenCode / Antigravity 与 Claude Desktop 均列为客户端路径
材料未说明：README 未说明在同一个服务器实例后面接入多个 MCP 客户端是否有受支持的协调方式。；README 未定义冲突请求发生时 Blender 场景状态的恢复行为。
视情况 我在 Linux 上用 Docker 运行 MCP 服务器，而 Blender 插件仍运行在宿主机 localhost；我能否按这个项目的部署方式连接两边？
适合读者： 在 Linux 上使用 Docker 部署 MCP 服务器、Blender 仍运行在宿主机、需要处理容器到 localhost 连接的自动化开发者

视情况，因为项目支持这种架构，但 Linux 不能直接使用 Docker 默认的 host.docker.internal，必须改用 host 网络和正确的 BLENDER_HOST。

  • Docker 章节说明容器只运行 MCP 服务器，Blender 仍运行在本机并连接到容器服务。
  • README 明确指出 Linux 不存在 host.docker.internal，且插件只监听 localhost。
  • Linux 配置要求 --network=host 并设置 BLENDER_HOST=localhost；缺少任一项都可能无法连接。
  • 客户端通过 stdin/stdout 与容器通信，因此 Docker 配置必须保留 -i，不能只运行后台容器。
  • README / Run with Docker："Blender itself still runs on your machine"
  • README / Run with Docker："On Linux, host.docker.internal doesn't exist"
  • README / Run with Docker / Linux 配置：`--network=host` 与 `-e`, `BLENDER_HOST=localhost`
  • README / Run with Docker："The -i flag is required"
docker build -t mcp-for-blender .
材料未说明：README 未说明 Linux 防火墙、SELinux 或企业容器策略对 host 网络模式的影响。；README 未给出 Docker 与特定 Blender 版本组合的验证列表。
适合 我的工作站是 locked-down machine，不能使用 uvx，但可以使用 pipx；我还需要把服务器接入 Claude Desktop 或 Cursor，这个项目是否适合这种安装约束？
适合读者： 在受限工作站上运行 Blender、不能依赖 uvx、希望用 pipx 配置 MCP 服务器的 Python 工具开发者

适合，因为 README 明确提供了不使用 uvx 的 pipx 安装路径；不过客户端必须指向 pipx 安装后的绝对命令路径。

  • Installation / Install without uv 明确写着 locked-down machines 可以跳过 uvx，使用 pipx 安装 mcp-for-blender。
  • README 要求运行 pipx ensurepath 后重启 shell 或客户端，并通过 which mcp-for-blender 或 where mcp-for-blender 找到路径。
  • 使用 pipx 时，客户端配置需要把 command 改成生成的绝对路径，并省略 args，这与默认的 uvx mcp-for-blender 配置不同。
  • Blender 插件仍需单独安装和启用，因此 pipx 只解决 MCP 服务器部署，不会替代 Blender 侧组件。
  • README / Installation / Install without uv："On locked-down machines you can skip uvx entirely with pipx"
  • README / Installation / Install without uv："Use the resulting absolute path as \"command\" ... and omit args."
  • README / Installing the Blender Addon：`uvx mcp-for-blender install-addon`
pipx install mcp-for-blender
材料未说明：README 未说明组织的代理、内部 PyPI 镜像或离线环境是否能正常安装该包。；README 未说明 pipx 环境下具体 Blender 版本与插件目录的兼容矩阵。
视情况 我已经用 Python 编写 Blender 自动化脚本，希望 Claude Code 通过 MCP 直接执行任意 Blender Python；这个项目适合用于包含重要工程文件的生产流程吗？
适合读者： 维护 Blender Python 自动化流程、希望让 MCP 客户端直接执行任意 Blender Python 代码的 Python 开发者

视情况：它非常适合扩展现有 Blender Python 自动化，但不宜在未经审查的模型和请求下直接开放给重要生产文件。

  • Features 明确提供 Code execution，可从 Claude 在 Blender 中运行任意 Python，因此覆盖面高于固定对象操作工具。
  • README 的 Safe mode 与 Limitations & Security Considerations 章节表明安全边界需要单独处理，而不是由 MCP 协议自动保证。
  • 项目洞察指出错误或破坏性脚本可能修改、删除场景内容，甚至访问不应访问的资源。
  • 项目数据还显示没有 latest release、release_count 为 0；若你的生产流程要求严格版本锁定和变更审计，当前仓库状态会增加治理不确定性。
  • README / Features："Code execution | Run arbitrary Python code in Blender from Claude"
  • README 章节：Safe mode、Limitations & Security Considerations
  • 项目洞察 / usage_limitations：任意 Python 执行带来较大的安全风险
  • 项目数据：latest_release 为空，release_count 为 0；main_language 为 Python
claude mcp add blender uvx mcp-for-blender
材料未说明：README 未说明 Safe mode 能阻止哪些具体 Python 操作，也未提供完整的权限模型。；README 未说明当前代码对应的稳定提交、版本标签或生产支持周期。
适合 我刚开始学习 Blender，使用 Claude Desktop，想通过“创建一个地下城低多边形场景”这类提示词完成建模和灯光设置；这个项目是否适合我？
适合读者： 使用 Claude Desktop、刚开始接触 Blender、希望通过自然语言创建低多边形场景的独立创作者

适合，因为它把 Claude Desktop 连接到本地 Blender，能降低初学者执行对象、材质和灯光操作的门槛，但不能替代 Blender 基础知识。

  • README 的 Features 列出对象创建、修改、删除、材质控制和场景检查。
  • Usage 的示例包含“Create a low poly scene in a dungeon…”以及调整工作室灯光，与你的目标直接对应。
  • Quickstart 要求同时配置 MCP 客户端、安装 Blender 插件，并在 3D 视图中点击 Start MCP Server；并不是只安装一个聊天工具即可使用。
  • 项目支持在 Blender 中执行任意 Python，因此复杂请求仍可能改变场景结构，初学者需要能够识别结果是否符合预期。
  • README / Features：Object manipulation、Material control、Scene inspection、Code execution
  • README / Usage / Example Commands："Create a low poly scene in a dungeon, with a dragon guarding a pot of gold"
  • README / Quickstart："In Blender's 3D viewport, press N ... click Start MCP Server"
uvx mcp-for-blender install-addon
材料未说明：README 未说明不同 Blender 版本对插件功能的具体兼容范围。；README 未量化复杂场景提示词的成功率、响应时间或生成质量。
适合 我需要在 Blender 概念场景中混用 Poly Haven、Sketchfab、Poly Pizza 的资产，并调用 Hyper3D Rodin 或 Hunyuan3D 生成模型；这个项目能否减少我在多个工具之间切换？
适合读者： 需要从 Poly Haven、Sketchfab、Poly Pizza 获取资产，并通过 Hyper3D Rodin 或 Hunyuan3D 生成模型的概念设计师

适合概念设计和快速原型，因为 README 把资产检索、导入与 AI 3D 模型生成列为同一套 Blender 工作流能力；但第三方服务条件仍决定最终可用性。

  • Features 明确列出 Poly Haven、Sketchfab、Poly Pizza，以及 Hyper3D Rodin 和 Hunyuan3D。
  • Usage 示例包括从 Poly Haven 获取 HDRI、纹理、岩石和植被，也包括用 Poly Pizza 填充低多边形家具。
  • README 同时提供 Hyper3D 生成花园地精的示例，说明工作流不只覆盖静态下载资产。
  • 项目洞察指出这些能力依赖 API 凭据、网络和第三方服务限制；因此它适合把流程集中到 Blender，不代表资产许可、服务稳定性或模型质量由项目统一保证。
  • README / Features / Asset & model generation：Poly Haven、Sketchfab、Poly Pizza、Hyper3D Rodin、Hunyuan3D
  • README / Usage / Example Commands："Create a beach vibe using HDRIs, textures, and models like rocks and vegetation from Poly Haven"
  • README / Usage / Example Commands："Fill this room with low-poly furniture from Poly Pizza"
  • README / Usage / Example Commands："Generate a 3D model of a garden gnome through Hyper3D"
uvx mcp-for-blender install-addon
材料未说明：README 未在提供内容中列出各资产源的完整授权限制和商用条件。；README 未说明 Hyper3D Rodin 与 Hunyuan3D 的具体 API 价格、配额、区域可用性或输出格式差异。

✨ 核心亮点

  • 支持任意LLM连接Blender并进行双向通信
  • 可创建物体、修改材质并检查Blender场景
  • 集成Poly Haven、Sketchfab与Hyper3D模型
  • 代码执行功能可从Claude运行任意Python代码

🔧 工程化

  • 用uvx mcp-for-blender安装MCP服务器与Blender插件
  • 通过Claude操作物体、材质、场景和Python代码
  • 通过Hyper3D Rodin和Hunyuan3D生成3D模型

⚠️ 风险

  • Code execution支持从Claude运行任意Python代码
  • Poly Haven下载期间Blender主线程会阻塞界面
  • Linux Docker需使用host网络和BLENDER_HOST设置
  • Poly Pizza CDN会拦截数据中心、VPN和云端IP

👥 适合谁？

  • 使用Claude与Blender制作AI辅助3D场景的开发者
  • 需要通过MCP客户端驱动Blender的Python团队
  • 需要Docker部署MCP服务器但本机运行Blender的用户