blender-open-mcp
2025.04.04
16
Python3D 建模AI 辅助设计开发效率内容生成
`blender-open-mcp` 是一个开源项目，通过 Model Context Protocol (MCP) 将 Blender 与本地 AI 模型（通过 Ollama）集成。该项目允许用户使用自然语言提示控制 Blender，利用 AI 的强大功能辅助完成 3D 建模任务。
View on GitHub
Overview
基本能力
产品定位
blender-open-mcp 是一个用于增强 Blender 3D 建模效率的工具，通过 AI 自然语言交互简化复杂操作。
核心功能
- 自然语言控制 Blender：通过本地运行的 Ollama 模型发送提示，执行 Blender 操作。
- MCP 集成：使用 Model Context Protocol 实现 AI 模型与 Blender 的结构化通信。
- Ollama 支持：支持本地模型管理。
- Blender 插件：提供用户界面并处理与服务器的通信。
- PolyHaven 集成（可选）：通过 AI 提示直接从 PolyHaven 下载和使用资源（HDRIs、纹理、模型）。
- 基本 3D 操作：
- 获取场景和对象信息
- 创建基本几何体
- 修改和删除对象
- 应用材质
- 渲染支持：渲染图像并根据输出获取信息。
适用场景
- 3D 建模师希望通过自然语言快速完成复杂操作。
- 开发者希望将 AI 能力集成到 Blender 工作流中。
- 需要从 PolyHaven 快速获取资源的用户。
工具列表
| 工具名称 | 描述 | 参数 |
|---|---|---|
get_scene_info |
获取场景详情 | 无 |
get_object_info |
获取对象信息 | object_name (str) |
create_object |
创建 3D 对象 | type, name, location, rotation, scale |
modify_object |
修改对象属性 | name, location, rotation, scale, visible |
delete_object |
删除对象 | name (str) |
set_material |
为对象分配材质 | object_name, material_name, color |
render_image |
渲染图像 | file_path (str) |
execute_blender_code |
在 Blender 中执行 Python 代码 | code (str) |
get_polyhaven_categories |
列出 PolyHaven 资源类别 | asset_type (str) |
search_polyhaven_assets |
搜索 PolyHaven 资源 | asset_type, categories |
download_polyhaven_asset |
下载 PolyHaven 资源 | asset_id, asset_type, resolution, file_format |
set_texture |
应用下载的纹理 | object_name, texture_id |
set_ollama_model |
设置 Ollama 模型 | model_name (str) |
set_ollama_url |
设置 Ollama 服务器 URL | url (str) |
get_ollama_models |
列出可用 Ollama 模型 | 无 |
常见问题解答
- 问题：Ollama 或
blender-open-mcp服务器未运行。 解决方案：确保两者均在运行。 - 问题：Blender 插件设置错误。 解决方案：检查插件设置并重新启用。
- 问题：命令行参数错误。 解决方案：验证参数并参考日志获取错误详情。
使用教程
使用依赖
- Blender：Blender 3.0 或更高版本。从 blender.org 下载。
- Ollama：从 ollama.com 安装，遵循操作系统特定指令。
- Python：Python 3.10 或更高版本。
- uv：使用
pip install uv安装。 - Git：用于克隆仓库。
安装教程
- 克隆仓库：
bash git clone https://github.com/dhakalnirajan/blender-open-mcp.git cd blender-open-mcp - 创建并激活虚拟环境（推荐）：
bash uv venv source .venv/bin/activate # Linux/macOS .venv\Scripts\activate # Windows - 安装依赖：
bash uv pip install -e . - 安装 Blender 插件：
- 打开 Blender。
- 转到
编辑 -> 首选项 -> 插件。 - 点击
安装...。 - 选择
blender-open-mcp目录中的addon.py文件。 - 启用 "Blender MCP" 插件。
- 下载 Ollama 模型（如未安装）：
bash ollama run llama3.2
调试方式
- 启动 Ollama 服务器：确保 Ollama 在后台运行。
- 启动 MCP 服务器：
bash blender-mcp或bash python src/blender_open_mcp/server.py - 启动 Blender 插件服务器：
- 打开 Blender 和 3D 视口。
- 按
N打开侧边栏。 - 找到 "Blender MCP" 面板。
- 点击 "Start MCP Server"。
示例命令
- 基本提示：
bash mcp prompt "Hello BlenderMCP!" --host http://localhost:8000 - 获取场景信息：
bash mcp tool get_scene_info --host http://localhost:8000 - 创建立方体：
bash mcp prompt "Create a cube named 'my_cube'." --host http://localhost:8000 - 渲染图像：
bash mcp prompt "Render the image." --host http://localhost:8000 - 使用 PolyHaven（如启用）：
bash mcp prompt "Download a texture from PolyHaven." --host http://localhost:8000