基本能力
产品定位
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
