项目简介

BlenderMCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接大型语言模型 (LLM) 客户端（如 Claude 和 Cursor）与 Blender 软件。通过 BlenderMCP Server，用户可以使用自然语言指令，让 LLM 客户端控制 Blender 进行 3D 建模、场景创建、材质编辑等操作，实现 AI 辅助的 3D 内容创作工作流。

主要功能点

双向通信: 通过 Socket 协议与 Blender 插件建立稳定连接，实现命令和数据的实时传输。
对象操控: 支持在 Blender 中创建、修改、删除 3D 对象，包括基本几何体、相机、灯光等。
材质控制: 允许应用和修改 Blender 对象的材质及颜色，实现外观定制。
场景信息获取: 提供获取 Blender 场景详细信息的功能，方便 LLM 理解当前场景状态。
代码执行: 支持在 Blender 中执行 Python 代码，提供强大的功能扩展能力。
Poly Haven 集成: 可选集成 Poly Haven 资源库，方便用户通过 LLM 指令调用和导入 Poly Haven 的 HDRI、纹理和模型素材。

安装步骤

环境准备:
- 确保已安装 Blender 3.0 或更高版本。
- 确保已安装 Python 3.10 或更高版本。
- 安装 'uv' 包管理器。根据您的操作系统，按照 uv 安装指南进行安装。对于 macOS 用户，推荐使用 'brew install uv' 安装。
配置 Claude 或 Cursor (选择其一):

Claude for Desktop 集成:
- 打开 Claude 应用，进入 "Settings" -> "Developer" -> "Edit Config"。
- 编辑 'claude_desktop_config.json' 文件，添加以下 'mcpServers' 配置：
```
{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}
```
  - 'command': 指定 MCP 服务器的启动命令，这里使用 'uvx' 运行 'blender-mcp' 包。
  - 'args': 传递给启动命令的参数，这里指定运行 'blender-mcp' 包。
Cursor 集成:
- 打开 Cursor 编辑器，进入 "Settings" -> "MCP"。
- 在 MCP 配置中，添加以下命令：
```
uvx blender-mcp
```
⚠️ 注意: 请勿同时在 Claude Desktop 和 Cursor 中运行 MCP 服务器，仅选择一个平台配置即可。
安装 Blender 插件:
- 从仓库下载 'addon.py' 文件。
- 打开 Blender 软件。
- 进入 "Edit" -> "Preferences" -> "Add-ons"。
- 点击 "Install..." 按钮，选择下载的 'addon.py' 文件。
- 在插件列表中，找到 "Interface: Blender MCP" 并勾选启用。

服务器配置

BlenderMCP Server 无需额外服务器端配置，其配置主要在 MCP 客户端 (如 Claude 或 Cursor) 中完成。客户端通过配置 'command' 和 'args' 来启动和连接 BlenderMCP Server。

基本使用方法

启动 Blender 插件:
- 在 Blender 中，打开 3D 视图侧边栏 (按 N 键显示/隐藏)。
- 找到 "BlenderMCP" 选项卡。
- 可选：如果需要使用 Poly Haven 资源，勾选 "Use assets from Poly Haven" 复选框。
- 点击 "Connect to Claude" 按钮启动 Blender 插件内置的 Socket 服务器。
连接 MCP 客户端:
- 确保已按照安装步骤配置好 Claude 或 Cursor 的 MCP 设置。
- 在 Claude 或 Cursor 中，您应该能看到一个锤子图标，其中包含 BlenderMCP 提供的工具。
使用工具:
- 通过自然语言指令，指示 Claude 或 Cursor 调用 BlenderMCP 提供的工具，例如：
  - '"Get scene information"' (调用 'get_scene_info' 工具)
  - '"Create a red sphere named 'ball' at location (1, 2, 3)"' (调用 'create_object' 工具)
  - '"Apply a metal material to the cube"' (调用 'set_material' 工具)
- 更多工具和使用示例请参考仓库 README.md 文件。

提示: 首次使用时，可能需要重启 Claude 或 Cursor 应用以确保 MCP 服务器配置生效。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息