blender-open-mcp

blender-open-mcp 是一个开源项目，它使用模型上下文协议 (MCP) 将 Blender 与本地 AI 模型（通过 Ollama）集成。这使您可以使用自然语言提示来控制 Blender，从而利用 AI 的力量来协助 3D 建模任务。

特性

• 使用自然语言控制 Blender： 将提示发送到本地运行的 Ollama 模型，以在 Blender 中执行操作。
• MCP 集成： 使用模型上下文协议在 AI 模型和 Blender 之间进行结构化通信。
• Ollama 支持： 旨在与 Ollama 配合使用，以便轻松进行本地模型管理。
• Blender 插件： 包括一个 Blender 插件，用于提供用户界面并处理与服务器的通信。
• PolyHaven 集成（可选）： 通过 AI 提示直接在 Blender 中下载和使用来自 PolyHaven 的资源（HDRIs、纹理、模型）。
• 基本 3D 操作：
  • 获取场景和对象信息
  • 创建基本体
  • 修改和删除对象
  • 应用材质
• 渲染支持： 使用该工具渲染图像并检索基于输出的信息。

安装

前提条件

1. Blender： Blender 3.0 或更高版本。 从 blender.org 下载。
2. Ollama： 从 ollama.com 安装，按照特定于操作系统的说明进行操作。
3. Python： Python 3.10 或更高版本。
4. uv： 使用 pip install uv 安装。
5. Git： 克隆存储库需要。

安装步骤

1. 克隆存储库：

   git clone https://github.com/dhakalnirajan/blender-open-mcp.git
   cd blender-open-mcp
   

2. 创建并激活虚拟环境（推荐）：

   uv venv
   source .venv/bin/activate  # 在 Linux/macOS 上
   .venv\Scripts\activate  # 在 Windows 上
   

3. 安装依赖项：

   uv pip install -e .
   

4. 安装 Blender 插件：

   • 打开 Blender。
   • 转到 编辑 -> 偏好设置 -> 插件。
   • 单击 安装...。
   • 从 blender-open-mcp 目录中选择 addon.py 文件。
   • 启用“Blender MCP”插件。

5. 下载 Ollama 模型（如果尚未安装）：

   ollama run llama3.2
   

   （也可以使用其他模型，例如 Gemma3。）

设置

1. 启动 Ollama 服务器： 确保 Ollama 在后台运行。

2. 启动 MCP 服务器：

   blender-mcp
   

   或者，

   python src/blender_open_mcp/server.py
   

   默认情况下，它监听 http://0.0.0.0:8000，但您可以修改设置：

   blender-mcp --host 127.0.0.1 --port 8001 --ollama-url http://localhost:11434 --ollama-model llama3.2
   

3. 启动 Blender 插件服务器：

   • 打开 Blender 和 3D 视口。
   • 按 N 打开侧边栏。
   • 找到“Blender MCP”面板。
   • 单击“启动 MCP 服务器”。

用法

使用 mcp 命令行工具与 blender-open-mcp 交互：

示例命令

• 基本提示：

  mcp prompt "Hello BlenderMCP!" --host http://localhost:8000
  

• 获取场景信息：

  mcp tool get_scene_info --host http://localhost:8000
  

• 创建一个立方体：

  mcp prompt "Create a cube named 'my_cube'." --host http://localhost:8000
  

• 渲染图像：

  mcp prompt "Render the image." --host http://localhost:8000
  

• 使用 PolyHaven（如果已启用）：

  mcp prompt "Download a texture from PolyHaven." --host http://localhost:8000
  

可用工具

工具名称	描述	参数
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 的插件设置。
• 验证命令行参数。
• 参考日志以获取错误详细信息。

如需更多帮助，请访问 GitHub Issues 页面。

---

使用 AI 快乐地进行 Blender 创作！ 🚀