JinDaGe - blender-open-mcp MCP Details

article

README

🚀 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 <model_name>
```

🚀 快速开始

启动服务

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。

blender-open-mcp