使用说明

项目简介

LLM Blender Agent 项目旨在通过集成多种大型语言模型（LLM），使用户能够通过自然语言指令控制Blender软件进行3D建模。它包含一个Blender MCP服务器插件（addon.py）和一个Python客户端（app.py, cli.py），允许用户以自然语言与LLM交互，并驱动Blender执行3D场景操作。

主要功能点

场景操作: 支持创建、修改和删除Blender场景中的对象。
材质管理: 可以为Blender对象设置和修改材质，包括颜色和纹理。
资源库集成: 集成了 Poly Haven 资源库，方便用户下载和应用高质量的 HDRIs、纹理和模型。
AI模型生成: 集成了 Hyper3D Rodin AI 模型生成服务，允许用户通过文本提示生成3D模型并导入Blender。
多LLM支持: 支持 Claude, Zhipu AI, DeepseekV3, AIMLAPI 等多种LLM接口，用户可以根据需要选择合适的LLM。
交互模式: 提供命令行界面（CLI）和 Gradio Web UI 两种交互方式，满足不同用户的需求。

安装步骤

安装Python依赖: 在项目根目录下，运行以下命令安装Python依赖库：

pip install -r requirements.txt

安装BlenderMCP插件:
- 复制 'addon.py' 文件到Blender的插件目录。通常，插件目录位于Blender安装目录下的 'scripts/addons' 文件夹中。
- 启动Blender软件。
- 在Blender的 '编辑' -> '偏好设置' -> '插件' 中，搜索并启用 "Blender MCP" 插件。

服务器配置

LLM Blender Agent 的 MCP 服务器是 Blender 软件内的 BlenderMCP 插件 ('addon.py')。该插件在Blender启动后即可通过界面操作启动，无需额外的命令行配置。MCP 客户端（例如 'app.py' 和 'cli.py'）需要配置连接到此服务器的信息。

以下是 MCP 客户端连接服务器的配置信息（以 'app.py' 为例，在 'app.py' 的界面中配置）：

{
  "server name": "BlenderMCP Server",
  "host": "localhost",  // MCP 服务器主机名，Blender MCP 插件默认运行在本地，所以通常为 localhost
  "port": 9876        // MCP 服务器端口号，Blender MCP 插件默认端口为 9876
}

注意: Blender MCP 服务器不需要单独的启动命令，它作为 Blender 插件运行在 Blender 软件内部。MCP 客户端需要配置正确的 'host' 和 'port' 才能连接到运行中的 Blender MCP 服务器。

基本使用方法

1. 启动Blender MCP服务器:

启动Blender软件并启用 BlenderMCP 插件。
在Blender界面右侧边栏找到 "BlenderMCP" 面板，点击 "Start MCP Server" 按钮启动服务器。

2. 运行MCP客户端 (Web UI 模式):

在项目根目录下，运行以下命令启动 Gradio Web UI 客户端：
```
python app.py
```
打开浏览器，访问 'http://localhost:7860'，即可使用 Web UI 界面与 Blender 进行交互。
在 Web UI 界面的 "连接设置" 标签页中，配置 Blender 主机和端口号（默认为 'localhost:9876'），点击 "连接到Blender" 按钮。
在 "连接设置" 标签页中，选择 LLM 模型，并点击 "初始化Agent" 按钮。
切换到 "对话" 标签页，即可输入自然语言指令，与 Blender 进行交互建模。

3. 运行MCP客户端 (命令行模式):

在项目根目录下，运行 'cli.py' 脚本，并指定要使用的 LLM 模型，例如使用 Claude 模型：
```
python cli.py --model claude
```
在命令行界面中，输入自然语言指令，与 Blender 进行交互建模。
输入 'quit' 或 'exit' 命令退出命令行客户端。

4. 配置LLM API 密钥:

编辑 'config.json' 文件，根据你选择的 LLM 模型，填入相应的 API 密钥。例如，配置 Claude API 密钥：

{
  "claude": {
    "api_key": "YOUR_CLAUDE_API_KEY",
    "model": "claude-3-opus-20240229"
  },
  // ... 其他 LLM 配置
}

关键词