Blender Open MCP

🚀 Blender MCP 开源项目

blender-open-mcp 是一个开源项目，它将 Blender 与基于 Ollama 的本地 AI 模型集成，实现了通过自然语言控制 Blender 的功能。借助模型上下文协议（MCP），用户能够使用自然语言指令完成复杂的 3D 建模任务。

✨ 主要特性

• 自然语言控制：可通过自然语言指令操作 Blender。
• MCP 集成：利用模型上下文协议实现高效交互。
• Ollama 支持：支持本地 AI 模型，具备强大的推理能力。
• Blender 插件：提供专门的插件以提升用户体验。
• PolyHaven 整合：可选择集成 PolyHaven 资源，丰富建模素材。

📦 安装指南

先决条件

• 确保已安装 Python 3.8 或更高版本。
• 安装 Git 和 pip 包管理工具。

安装步骤

1. 克隆仓库：使用以下命令获取项目代码：

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

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

   cd blender-open-mcp
   python -m venv env
   source env/bin/activate  # 在 Linux/Mac 上
   # 或者在 Windows 上：.\env\Scripts\activate
   

3. 安装依赖项：

   pip install -r requirements.txt
   

4. 安装 Blender 插件：
   • 将插件文件复制到 Blender 的插件目录。
   • 在 Blender 中启用该插件。
5. 下载 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

📚 详细文档

常见问题

⚠️ 重要提示

• 确保 Ollama 和 MCP 服务器均正常运行。
• 检查 Blender 插件是否正确启用。
• 核对命令行参数，避免格式错误。

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