Blender Open MCP

社区

通过本地AI模型用自然语言控制Blender 3D

分类: 开发工具第 355 / 438
Stars: ★ 120 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Python 3.10+ · 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 37 天前
工具数: 16

40FMRS · D

该服务器提供了一个实用的MCP集成，通过本地Ollama模型实现自然语言控制Blender，适合开发者和3D艺术家。其架构清晰，工具丰富，包括场景操作、材质、渲染和AI辅助。但执行任意代码和删除对象的功能带来安全风险，需谨慎使用。非官方项目，依赖本地模型，不适合需要云AI或低安全风险的用户。

最强项 · 文档质量 13/20 最弱项 · 安全与权限 3/20

可靠性

6/20

安全与权限

3/20

维护活跃度

6/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 6/20: 证据仅来自 README：它描述了 FastMCP、Blender 插件和 Ollama 三进程架构，列出了 15 个工具、CLI/Python 客户端和默认端口。扣分原因：没有提供仓库源码、CI 工作流或已提交的测试，无法验证 MCP 初始化握手、工具列表与实际行为是否一致；README 本身包含错误的 Ollama 命令（`ollama pull ollama run llama3.2`），也缺少错误路径文档。按静态校准规则，在缺少可验证执行证据的情况下分数不能给高。
安全与权限 3/20: 存在明确的红线风险：`blender_execute_code` 可在 Blender 中执行任意 Python/bpy 代码，`blender_delete_object` 可删除场景对象，而文档中未显示任何用户确认机制、权限隔离或最小权限设计；此外 PolyHaven 下载引入了外部网络面。因此安全维度被限制在 0-4 分区间，评 3 分。没有可评估的凭据处理流程，安装示例中也未发现真实令牌。
维护活跃度 6/20: 证据显示仓库未归档，有 109 星（仅作为发现信号）和 13 个开放 issue，README 声称使用 MIT 许可证。扣分原因：元数据显示许可证为 NOASSERTION，缺少可确认的 LICENSE 文件；没有发布记录、提交频率、依赖更新策略、安全问题响应渠道；issue 响应速度和维护持续性无法从现有材料判断。
文档质量 13/20: 证据：README 提供了架构图、环境要求、Blender 插件安装步骤、服务端/客户端用法、工具表（含是否修改 Blender 的标记）、默认端口、开发命令和常见问题排查表，结构较完整。扣分原因：缺少每个工具的参数 schema、错误码、鉴权与安全说明、资源/成本限制；文档是单层的，且没有与真实行为对照的可复现证据，因此未给满分。
安装易用性 12/20: 证据：安装流程分步清晰，包括 uv 环境、Blender 插件安装、Ollama 模型拉取、MCP 服务启动命令，并给出了 Claude/Cursor 的 mcp.json 配置示例。扣分原因：实际需要手动启动并维护 Blender、Ollama 和 MCP 三个独立进程，Blender 插件安装依赖 GUI 操作，且没有 CI 验证的冒烟测试或平台专项说明；静态校准要求在没有可验证执行证据时安装分数不超过 15，故评 12。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件执行命令或代码访问网络

适合谁

希望用本地AI模型控制Blender的3D艺术家
需要自动化3D工作流的开发者
集成Claude Desktop或Cursor进行AI辅助建模的用户

不适合谁

没有本地Ollama或无法运行本地LLM的用户
需要云AI服务的用户（因为使用本地模型）
不熟悉Blender插件安装的用户
需要官方支持的用户（非官方项目）

所需权限

能读取和修改Blender场景（对象、材质、变换）
能执行任意Python/bpy代码（通过blender_execute_code）
能删除对象（blender_delete_object）
能渲染图像到文件
能访问互联网以下载PolyHaven资源
能通过Ollama访问本地模型
需要网络端口（8000、9876、11434）

风险与副作用

执行任意代码可能损坏场景或系统，如果提供了恶意提示
删除对象操作不可逆，可能丢失工作
PolyHaven下载需要互联网连接，可能失败
本地LLM可能产生不准确的代码，需要检查后执行
非官方项目，可能存在bug或安全漏洞

安装接入

准备工作

运行环境：Python 3.10+ · 预编译二进制

安装依赖：Blender 3.0+，Python 3.10+，Ollama，uv。
克隆仓库并设置虚拟环境：uv venv，激活，uv pip install -e .。
在Blender中安装插件：编辑→偏好设置→插件→安装，选择addon.py，启用“Blender MCP”，在3D视口N侧边栏启动MCP服务器（默认端口9876）。
拉取Ollama模型：ollama pull ollama run llama3.2。
启动Ollama服务器。
启动MCP服务器：blender-mcp，或使用自定义选项，如--transport stdio。

claude_desktop_config.json

{
  "mcpServers": {
    "blender-open-mcp": {
      "command": "blender-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

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

.vscode/mcp.json

{
  "servers": {
    "blender-open-mcp": {
      "command": "blender-mcp",
      "args": [
        "--transport",
        "stdio"
      ]
    }
  }
}

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

Terminal

claude mcp add blender-open-mcp -- blender-mcp --transport stdio

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

生成并校验客户端配置

验证是否装好

在 Blender 中启动 add-on 的 MCP Server 并运行 ollama serve 后，启动 blender-mcp --transport stdio；在客户端工具列表中应能看到 blender_get_scene_info，调用它若返回场景信息即证明连接正常。

常见排障

无法连接Blender插件：在Blender侧边栏启动MCP服务器
无法连接Ollama：运行`ollama serve`
对象未找到：使用`blender_get_scene_info`检查确切名称
渲染失败：确保输出目录存在且可写
PolyHaven下载失败：检查网络连接，尝试较低分辨率

试试这样问

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

查看当前场景里有哪些物体
在位置 0, 0, 2 创建一个金属质感的球体
给 MyCube 应用一张砖墙纹理
渲染当前场景并保存为图片

工具能力 16

blender_get_scene_info 只读

获取完整场景摘要：对象、相机、渲染设置

blender_get_object_info 只读

获取详细对象信息：变换、材质、网格统计

blender_create_object 写入

添加基本网格（立方体、球体、圆柱体等）

blender_modify_object 写入

更改位置、旋转、缩放、可见性

blender_delete_object 破坏性

从场景中删除对象

blender_set_material 写入

创建并分配原理化BSDF材质

blender_render_image 写入

将当前场景渲染到文件

blender_execute_code 破坏性

在Blender中运行任意Python/bpy代码

展开其余 8 个工具

blender_get_polyhaven_categories 只读

列出PolyHaven资源类别

blender_search_polyhaven_assets 只读

搜索PolyHaven库并分页

blender_download_polyhaven_asset 写入

下载并导入PolyHaven资源

blender_set_texture 写入

将下载的PolyHaven纹理应用到对象

blender_ai_prompt 只读

向Ollama发送自然语言提示

blender_get_ollama_models 只读

列出可用的本地Ollama模型

blender_set_ollama_model 写入

切换当前Ollama模型

blender_set_ollama_url 写入

更新Ollama服务器URL

使用场景

通过自然语言命令在Blender中创建和修改3D对象

使用AI助手生成和执行bpy代码

从PolyHaven下载并应用纹理

自动渲染场景

获取场景和对象信息以供AI分析

支持客户端

Claude Desktop

Cursor

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

详细介绍

基于模型上下文协议（MCP）构建，将Claude、Cursor或任何MCP客户端通过本地Ollama LLM连接到Blender。使用FastMCP服务器、Blender插件和Ollama实现架构。