使用说明

项目简介

BlenderMCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在桥接 LLM 客户端（如 Claude AI）与 Blender 软件，实现通过自然语言指令控制 Blender 进行 3D 建模、场景编辑等操作。该项目包含 MCP 服务器端和 Blender 插件两部分，共同构建起 LLM 与 Blender 交互的完整链路。

主要功能点

双向通信: 基于 Socket 实现 MCP 服务器与 Blender 插件的双向通信。
Blender 控制: 提供工具 (Tools) 允许 MCP 客户端控制 Blender，包括：
- 对象操作: 创建、修改、删除 Blender 场景中的 3D 对象。
- 材质控制: 应用和修改对象的材质及颜色。
- 场景信息获取: 获取 Blender 场景和对象的详细信息。
- 代码执行: 在 Blender 中执行任意 Python 代码。
Poly Haven 集成: 集成 Poly Haven 资源库，支持检索、下载和导入 Poly Haven 的 HDRI、纹理和模型资源。
Hyper3D Rodin 集成: 集成 Hyper3D Rodin，支持通过文本描述或参考图像生成 3D 模型，并导入到 Blender 中。

安装步骤

环境准备: 确保已安装 Blender 3.0 或更高版本，Python 3.10 或更高版本。
安装 uv 包管理器: 按照仓库 README.md 中的 "Installation" 章节的指引安装 'uv' 包管理器。
下载代码: 克隆或下载 GitHub 仓库 blender-mcp 的代码。
安装 Blender 插件:
- 下载仓库中的 'addon.py' 文件。
- 打开 Blender，进入 '编辑 (Edit)' -> '偏好设置 (Preferences)' -> '插件 (Add-ons)'。
- 点击 '安装 (Install...)' 按钮，选择下载的 'addon.py' 文件进行安装。
- 在插件列表中找到 "Blender MCP" 并勾选启用。
启动 MCP 服务器:
- 打开终端，进入仓库根目录。
- 运行命令 'uvx blender-mcp' 启动 MCP 服务器。（注意: 首次运行可能需要一些时间安装依赖）

服务器配置

MCP 客户端（如 Claude AI）需要配置以下 JSON 信息以连接 BlenderMCP 服务器。

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

'mcpServers': 定义 MCP 服务器配置的对象。
'blender': 服务器名称，可以自定义。
'command': 启动 BlenderMCP 服务器的命令，使用 'uvx' 运行 'blender-mcp' 包。
'args': 传递给 'command' 的参数，指定运行 'blender-mcp' 包。

请注意: MCP 客户端需要将以上 JSON 配置添加到其开发者配置中 (例如 Claude 的 'claude_desktop_config.json')。具体配置方法请参考客户端的文档。

基本使用方法

确保 BlenderMCP 服务器已在终端运行。
确保 Blender 软件已打开，并且 BlenderMCP 插件已启用，插件状态显示 "Server Running"。
在 MCP 客户端（如 Claude AI）中，选择配置好的 "blender" 服务器。
通过 MCP 客户端的工具面板或命令，即可调用 BlenderMCP 服务器提供的各项功能，控制 Blender 进行 3D 创作。

例如在 Claude 中： 在配置完成后，Claude 的工具栏中会出现 BlenderMCP 的锤子图标，点击即可使用 BlenderMCP 提供的各种工具，如 'create_object' (创建物体)、'modify_object' (修改物体)、'get_scene_info' (获取场景信息) 等。

关键词