使用说明

项目简介

Blender AI智能助手是一个基于Model Context Protocol (MCP) 的应用后端，它通过AI Agent和Google Gemini 2.0 Flash，实现了使用自然语言控制Blender的功能。该项目将Blender与AI能力深度整合，允许用户通过对话方式进行3D建模、动画制作和视觉效果设计，极大地提升了Blender的操作效率和智能化水平。

主要功能点

自然语言控制Blender: 通过日常对话语言与Blender进行交互，无需手动操作复杂的Blender界面。
持久化聊天记录: 所有对话历史都会被保存，方便用户回顾和参考。
会话管理: 支持创建和管理多个建模会话，用户可以根据项目需求进行切换。
高级建模辅助: 提供专业的建模技术指导和操作建议。
资源集成: 可以从Poly Haven下载和导入3D模型资源。
AI生成3D模型: 支持通过文本描述或图像生成3D模型 (使用Hyper3D)。
自定义材质创建: 通过简单的文本命令创建和应用材质。
Python脚本执行: 允许通过AI Agent执行自定义的Blender Python脚本。

安装步骤

安装 Blender: 确保已安装 Blender 3.0 或更高版本。
安装 Python: 确保已安装 Python 3.10 或更高版本。
安装 uv 包管理器:
- macOS: 运行 'brew install uv'
- Windows: 运行 'powershell -c "irm https://astral.sh/uv/install.ps1 | iex"'，并配置环境变量Path。
- 其他平台请参考 uv 安装指南。
安装 Blender MCP 插件:
- 下载仓库中的 'addon.py' 文件。
- 打开 Blender，进入 "编辑" > "偏好设置" > "插件"。
- 点击 "安装..." 并选择 'addon.py' 文件。
- 勾选 "界面: Blender MCP" 复选框启用插件。
设置 AGNO Agent:
- 克隆仓库: 'git clone https://github.com/WaiGenie/BlenderMCP-AI-AGNO-agent.git'
- 进入目录: 'cd blender-mcp-agent'
- 安装依赖: 'pip install -r requirements.txt'
- 配置环境变量: 创建 '.env' 文件并添加API keys。

服务器配置

本项目的MCP服务器端（即运行 'trail.py' 的 Python 脚本）无需额外配置。对于需要连接到此MCP服务器的MCP客户端（例如 Claude for Desktop 或 Cursor），您需要配置 MCP 服务器的启动命令和参数。

MCP客户端配置（JSON 格式示例，以Claude for Desktop为例）：

{
    "mcpServers": {
        "blender": {
            "command": "uvx", // MCP服务器启动命令，通常为 uvx，用于运行 blender-mcp
            "args": [
                "blender-mcp"  // MCP服务器启动参数，指定运行 blender-mcp
            ]
        }
    }
}

command: MCP服务器的启动命令。这里使用 'uvx' 是为了方便管理和运行 'blender-mcp'。请确保 'uvx' 已正确安装并可在命令行中访问。如果 'uvx' 不在系统 PATH 中，您需要提供 'uvx' 可执行文件的完整路径。
args: 启动命令的参数。对于本项目，参数为 'blender-mcp'，指定了要通过 'uvx' 运行的 MCP 服务器。

基本使用方法

启动 Blender: 确保 Blender 软件已打开，并且 Blender MCP 插件已启用。
运行 AGNO Agent: 在命令行中，进入项目目录并运行 'python trail.py'。
连接 Claude 或 Cursor (可选): 如果您希望在 Claude for Desktop 或 Cursor 中使用，请根据仓库 README 中的说明配置 MCP 服务器连接。
自然语言交互: 在 'trail.py' 运行的命令行界面中，输入自然语言指令与 Blender AI 智能助手进行交互。例如，您可以输入 "创建一个红色的立方体" 或 "导入一张木质纹理"。

关键词: Blender, 3D建模, AI助手, 自然语言控制, 智能创作

关键词