← 返回目录

Blender MCP

社区

连接 Blender 与任何 LLM 的开源 MCP 服务器，实现 AI 辅助 3D 建模。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 133 / 438
Stars: ★ 30.5k 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · Docker
凭据: 可选 API Key
许可证: MIT
最近提交: 5 天前
工具数: 14

59FMRS · C

BlenderMCP 是一个功能丰富的开源项目，为 LLM 与 Blender 交互提供了强大桥梁，受到社区欢迎。其亮点包括多种外部资源集成和双机通信，但存在任意代码执行的安全隐患，用户需谨慎使用。

最强项 · 文档质量 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

8/20

维护活跃度

14/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 证据仅限于 README，未提供 manifest、测试或 CI 文件，因此无法验证可复现性。架构（Blender 插件 socket 服务端 + MCP stdio 服务端）描述一致，并通过 BLENDER_HOST/BLENDER_PORT 环境变量控制连接，启动具有一定可控性。扣分点：缺少已提交的测试与 CI 证据；README 自认首个命令有时不生效，且服务依赖人工启动的外部 Blender 进程，错误不完全可控。按静态校准规则，缺少可验证的执行证据，不能超过 12，故给 8。
安全与权限 8/20: 主要风险是 execute_blender_code 会在 Blender 内执行任意 Python，可能产生主机侧副作用（读写文件、访问网络等）；README 已披露并警告先保存，但未描述确认或沙箱机制。API 密钥通过插件偏好或环境变量管理，安装示例中没有真实令牌，这点良好。遥测已披露，可用 DISABLE_TELEMETRY 或同意复选框控制，但即便是“不同意”也会收集最小使用数据，且征得同意时会收集提示词/代码片段/截图，数据边界披露不完整。外部网络调用（Poly Haven、Sketchfab、Hyper3D、Hunyuan3D）均已披露。未构成红线，因为这是已披露的核心功能，但权限与作用域控制不完整，故给 8。
维护活跃度 14/20: 具有 MIT 许可，仓库未归档，README 引用了 releases 页面和 changelog，并有赞助入口与 Discord 支持渠道；README 显示持续新增功能（Hunyuan3D、Hyper3D、Poly Haven、远程主机、遥测），表明项目活跃。扣分点：95 个未关闭 issue 偏多；未见安全响应渠道或依赖更新记录；在提供的材料中无法验证提交频率与发布节奏，故给 14。
文档质量 16/20: README 层次完整：各操作系统 uv 安装、多个客户端配置（Claude Desktop/Code、Cursor、VS Code、OpenCode）、插件安装、环境变量、用法与示例命令、遥测控制、凭证持久化，以及含 uvx ENOENT 和首命令失败在内的排障章节，并披露了安全限制。扣分点：缺少逐工具参数参考（manifest 未提供），成本信息较薄（仅 Hyper3D 试用限制），Poly Haven 等已知不稳定行为仅简要提及，故给 16。
安装易用性 13/20: 多组件安装步骤清晰，包含各客户端 JSON 示例和各平台说明（macOS/Windows/Linux），以及 PATH 修复和 pipx 备选方案，平台兼容性说明较全。但整体仍偏手工且脆弱：需要安装 uv、配置客户端、下载 addon.py、在 Blender 中安装启用并单独启动 socket 连接；已知失败项需要手动绕行。按静态校准，所提供的证据中没有 CI/测试，故封顶 15；实际给 13。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

3D 艺术家和建模师，希望通过自然语言与 Blender 交互并提高工作效率。
开发者希望将 Blender 集成到 AI 工作流中。

不适合谁

不适合需要严格安全控制的自动化环境，因为 execute_blender_code 允许任意代码执行。
不适合需要可靠实时渲染或复杂动画的用户，因为工具主要面向场景创建和修改。

所需权限

允许 MCP 服务器网络访问 Blender 套接字端口（默认 9876）。
允许执行任意 Python 代码，这可访问文件系统和其他系统资源。
外部 API 密钥（Sketchfab、Hyper3D、Hunyuan3D）用于资源下载和模型生成。

风险与副作用

execute_blender_code 工具可以运行任意代码，可能导致数据丢失或系统损坏。使用前务必保存工作。
Poly Haven 集成可能下载大量资源，消耗带宽和存储。
远程运行时，网络连接可能暴露。
第三方 API 可能有使用限制或费用。

安装接入

准备工作

运行环境：Python 3.10+ · Docker

BLENDERMCP_SKETCHFAB_API_KEY 可选密钥 Sketchfab API 密钥，用于搜索和下载 Sketchfab 模型。

BLENDERMCP_POLYPIZZA_API_KEY 可选密钥 Poly Pizza API 密钥，在 poly.pizza/settings/api 免费获取。

BLENDERMCP_HYPER3D_API_KEY 可选密钥 Hyper3D Rodin API 密钥，用于 AI 生成 3D 模型。

BLENDERMCP_HUNYUAN3D_SECRET_ID 可选密钥腾讯云 Hunyuan3D 的 SecretId，来自腾讯云账户。

BLENDERMCP_HUNYUAN3D_SECRET_KEY 可选密钥腾讯云 Hunyuan3D 的 SecretKey，来自腾讯云账户。

其他可选配置项（6 个）

BLENDER_HOST 可选 Blender socket 服务器的主机地址，默认 localhost；Docker 下常用 host.docker.internal。

BLENDER_PORT 可选 Blender socket 服务器的端口，默认 9876，运行多个实例时需各自指定。

BLENDER_MCP_SAFE_MODE 可选设为 1 可在脚本运行前校验并拦截危险代码。

UV_PYTHON_PREFERENCE 可选设为 only-managed 可避免 uv 选用 conda/pyenv 等系统解释器导致安装失败。

DISABLE_TELEMETRY 可选设为 true 可完全关闭匿名遥测数据收集。

BLENDERMCP_HUNYUAN3D_API_URL 可选 Hunyuan3D 的 API 端点地址，按账户所在区域（大陆/国际）选择。

安装 Blender 3.0 或更高版本。
安装 Python 3.10+ 和 uv 包管理器。
从仓库下载 addon.py 文件，在 Blender 中通过 Edit > Preferences > Add-ons > Install... 安装并启用它。
在 Claude Desktop 的 claude_desktop_config.json 中添加 MCP 服务器配置，使用 uvx 运行 blender-mcp。
在 Blender 中，打开 3D 视图侧边栏（按 N），找到 'BlenderMCP' 选项卡，点击 'Connect to Claude'。
确保 MCP 服务器在客户端中运行。

claude_desktop_config.json

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["--python", "3.11", "blender-mcp"],
      "env": { "UV_PYTHON_PREFERENCE": "only-managed" }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "blender": {
      "command": "uvx",
      "args": [
        "--python",
        "3.11",
        "blender-mcp"
      ],
      "env": {
        "UV_PYTHON_PREFERENCE": "only-managed"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add blender -e UV_PYTHON_PREFERENCE=only-managed -- uvx --python 3.11 blender-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Blender 侧边栏的 MCP for Blender 面板点击 Start MCP Server 后，向 AI 客户端发送提示，若客户端工具列表中出现 blender 服务器的工具（如 Get Scene Info），且执行"获取场景信息"能返回场景内容，即说明连接成功。

常见排障

连接问题：确保 Blender 插件已启用并点击 'Connect to Claude'，MCP 服务器在客户端中配置正确，不要手动运行 uvx 命令。
超时错误：简化请求或分解步骤。
PATH 问题：确保客户端能找到 uvx 的完整路径，或使用 cmd /c 包装。
Python 版本冲突：使用 --python 3.11 和 UV_PYTHON_PREFERENCE=only-managed。
重启客户端和服务器：完全退出并重新启动。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

获取当前场景的信息，并列出所有对象
创建一个低多边形的地下城场景，有一条龙守着一大锅金子
用 Poly Haven 的岩石和植被模型创建一个海滩氛围
把选中的对象删掉，再创建一个位于立方体上方的球体

工具能力 14

Get Scene Info 只读

获取当前 Blender 场景的详细信息。

Get Object Info 只读

获取指定对象的属性信息。

Create Object 写入

在场景中创建新的 3D 对象。

Modify Object 写入

修改现有对象的位置、旋转、缩放等属性。

Delete Object 破坏性

删除场景中的对象。

Apply Material 写入

为对象应用现有材质。

Create Material 写入

创建新材质并设置颜色等属性。

Execute Blender Code 写入

在 Blender 中执行任意 Python 代码（高风险）。

展开其余 6 个工具

Search Sketchfab 只读

在 Sketchfab 上搜索 3D 模型。

Download Sketchfab Model 写入

下载 Sketchfab 模型到 Blender 场景。

Load Poly Haven Asset 写入

从 Poly Haven API 加载模型、纹理或 HDRI。

Generate Hyper3D Model 写入

通过 Hyper3D Rodin API 生成 3D 模型。

Generate Hunyuan3D Model 写入

通过 Hunyuan3D API 生成 3D 模型。

Capture Screenshot 只读

捕获 Blender 视口的截图以了解场景。

使用场景

让 Claude 根据文本提示创建复杂的 3D 场景，如 '在 dungeon 中创建 low poly 场景，有龙守护一罐金子'。

从参考图像生成 Blender 场景。

使用 Poly Haven 资源（HDRI、纹理、模型）创建海滩氛围。

通过 Hyper3D 或 Hunyuan3D 生成 AI 3D 模型。

修改现有场景的材质和灯光。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

BlenderMCP 是一个开源项目，通过模型上下文协议（MCP）将 Blender 连接到 Claude AI，使 Claude 能够直接操控 Blender。它支持场景创建、对象操作、材质控制、Python 代码执行等功能。该服务器由两部分组成：Blender 插件（addon.py）创建套接字服务器，以及 MCP Python 服务器。工具集包括获取场景/对象信息、创建/修改/删除对象、应用材质、执行任意 Python 代码，甚至集成 Sketchfab、Poly Haven 和 Hyper3D 等外部资源。安装要求 Blender 3.0+、Python 3.10+ 和 uv 包管理器。