🚀 Blender MCP 开源项目
blender-open-mcp 是一个开源项目，它将 Blender 与基于 Ollama 的本地 AI 模型集成，实现了通过自然语言控制 Blender 的功能。借助模型上下文协议（MCP），用户能够使用自然语言指令完成复杂的 3D 建模任务。
✨ 主要特性
- 自然语言控制：可通过自然语言指令操作 Blender。
- MCP 集成：利用模型上下文协议实现高效交互。
- Ollama 支持：支持本地 AI 模型，具备强大的推理能力。
- Blender 插件：提供专门的插件以提升用户体验。
- PolyHaven 整合：可选择集成 PolyHaven 资源，丰富建模素材。
📦 安装指南
先决条件
- 确保已安装 Python 3.8 或更高版本。
- 安装 Git 和 pip 包管理工具。
安装步骤
- 克隆仓库：使用以下命令获取项目代码：
git clone https://github.com/dhakalnirajan/blender-open-mcp.git - 创建虚拟环境（推荐）：
cd blender-open-mcp python -m venv env source env/bin/activate # 在 Linux/Mac 上 # 或者在 Windows 上：.\env\Scripts\activate - 安装依赖项：
pip install -r requirements.txt - 安装 Blender 插件：
- 将插件文件复制到 Blender 的插件目录。
- 在 Blender 中启用该插件。
- 下载 Ollama 模型：
使用以下命令获取所需的 AI 模型：
ollama pull
🚀 快速开始
启动服务
- Ollama 服务器：运行
ollama serve。 - Blender MCP 服务：启动后端服务以提供 API 支持。
示例命令
mcp prompt "创建一个立方体" --host http://localhost:8000
💻 使用示例
基础用法
mcp prompt "创建一个立方体" --host http://localhost:8000
高级用法
# 更复杂的指令示例，例如创建一个特定位置和大小的球体
mcp prompt "创建一个半径为 2，位于 (1, 2, 3) 位置的球体" --host http://localhost:8000
📚 详细文档
| 工具名称 | 描述 | 参数 |
|---|---|---|
get_scene_info |
获取场景信息 | 无 |
get_object_info |
获取对象详细信息 | object_name (字符串) |
create_object |
创建 3D 对象 | type, name, location, rotation, scale |
modify_object |
修改对象属性 | name, location, rotation, scale, visible |
delete_object |
删除对象 | name (字符串) |
set_material |
为对象设置材质 | object_name, material_name, color |
render_image |
渲染图像 | file_path (字符串) |
execute_code |
执行 Blender 脚本 | code (字符串) |
search_assets |
搜索 PolyHaven 资源 | asset_type, categories |
download_asset |
下载指定资源 | asset_id, asset_type, resolution, file_format |
set_texture |
应用下载的贴图 | object_name, texture_id |
switch_model |
切换 Ollama 模型 | model_name (字符串) |
update_url |
更新 Ollama 服务地址 | url (字符串) |
list_models |
获取可用 Ollama 模型列表 | 无 |
常见问题
⚠️ 重要提示
- 确保 Ollama 和 MCP 服务器均正常运行。
- 检查 Blender 插件是否正确启用。
- 核对命令行参数，避免格式错误。
如需更多帮助，请访问 GitHub Issues。