文档中心
跳转至网站

我们可以帮助您吗?

CC-Car

主题

加入交流群

Claude交流群

群号：1025463125

加入群聊

BlenderMCP - Blender 与 Claude AI 集成 ​

BlenderMCP 通过模型上下文协议（MCP）将 Blender 与 Claude AI 连接起来，允许 Claude 直接与 Blender 交互和控制。此集成支持基于提示的三维建模、场景创建与操作。

注意

我们没有官方网站。您在网上看到的任何网站均为非官方网站，与本项目没有任何关联。使用此类网站需自行承担风险。

功能特性 ​

核心功能 ​

  • 双向通信：通过基于套接字的服务器将 Claude AI 连接到 Blender
  • 对象操作：在 Blender 中创建、修改和删除 3D 对象
  • 材料控制：应用和修改材料和颜色
  • 场景检查：获取有关当前 Blender 场景的详细信息
  • 代码执行：在 Blender 中从 Claude 运行任意 Python 代码

最新功能（v1.2.0） ​

  • 查看 Blender 视口的屏幕截图，以便更好地了解场景
  • 搜索并下载 Sketchfab 模型
  • 通过 API 支持 Poly Haven 资产
  • 支持使用 Hyper3D Rodin 生成 3D 模型

系统要求 ​

  • Blender：3.0 或更高版本
  • Python：3.10 或更高版本
  • UV 包管理器：必须安装

安装步骤 ​

1. 安装 Python 3.10+ ​

提示

如果已经安装了 Python 3.10 或更高版本，可以跳过此步骤。

macOS 系统：

bash
# 使用 Homebrew 安装
brew install python@3.10

或手动安装：从 Python 官网 下载安装包

Windows 系统：

从 Python 官网 下载并安装

Linux (Debian/Ubuntu) 系统：

bash
sudo apt-get install python3.10

验证安装：

bash
python3 --version

应该显示 Python 3.10.x 或更高版本。

2. 安装 UV 包管理器 ​

重要

在继续之前，必须先安装 UV 包管理器！

macOS 系统：

bash
brew install uv

Windows 系统：

powershell
# PowerShell 中运行
irm https://astral.sh/uv/install.ps1 | iex

# 设置环境变量
set Path=C:\Users\你的用户名\.local\bin;%Path%

手动安装：

访问 UV 安装指南

验证安装：

bash
uv --version

3. 安装 Blender 插件 ​

  1. 从 GitHub 仓库 下载 addon.py 文件
  2. 打开 Blender
  3. 前往 编辑 → 首选项 → 附加组件
  4. 点击 安装... 并选择 addon.py 文件
  5. 勾选 "界面：Blender MCP" 旁边的复选框启用插件

4. 配置 MCP 服务器 ​

Claude Desktop 集成 ​

  1. 打开 Claude Desktop
  2. 前往 Claude → 设置 → 开发者 → 编辑配置
  3. 在 claude_desktop_config.json 中添加：
json
{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

Cursor 集成 ​

macOS 用户：

前往 设置 → 管理控制面板，然后粘贴以下内容：

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

Windows 用户：

前往 设置 → 管理控制面板 → 添加服务器：

json
{
    "mcpServers": {
        "blender": {
            "command": "cmd",
            "args": [
                "/c",
                "uvx",
                "blender-mcp"
            ]
        }
    }
}

注意

只能运行一个 MCP 服务器实例（在 Cursor 或 Claude Desktop 上），不能同时在两个服务器上运行。

Visual Studio Code 集成 ​

请确保已安装 Visual Studio Code 后再继续。

5. 运行 MCP 服务器 ​

安装完成所有必备组件并配置好后，需要手动运行 MCP 服务器：

bash
uvx blender-mcp

重要提示

  • 确保 MCP 服务器只有一个实例在运行
  • 不能同时在 Cursor 和 Claude Desktop 上运行
  • 服务器需要在终端中保持运行状态

使用方法 ​

启动连接 ​

  1. 启动 MCP 服务器：在终端中运行 uvx blender-mcp
  2. 在 Blender 中打开 3D 视图侧边栏（如果看不到，按 N 键）
  3. 找到 "BlenderMCP" 选项卡
  4. （可选）勾选 Poly Haven 复选框以使用 Poly Haven API 资源
  5. 点击 "连接到 Claude"

在 Claude 中使用 ​

配置完成后，你会在 Claude 界面看到一个锤子图标，显示 Blender MCP 的可用工具。

示例命令 ​

以下是一些你可以让 Claude 执行的示例：

场景创建 ​

创建一个低多边形场景，场景设定在地牢中，一条龙守护着一罐金子

使用 Poly Haven 资源 ​

使用 Poly Haven 中的 HDRIs、纹理和模型（例如岩石和植被）营造海滩氛围

基于参考图片 ​

提供一张参考图片，并根据该图片创建一个 Blender 场景

3D 模型生成 ​

使用 Hyper3D 生成花园小矮人的 3D 模型

场景导出 ​

获取当前场景信息，并据此生成一个 three.js 草图

对象修改 ​

把这辆车改成红色金属色

基础操作 ​

创建一个球体并将其放置在立方体上方

灯光设置 ​

把灯光布置得像摄影棚一样

相机控制 ​

将摄像机对准场景，并拍摄等距视角照片

环境变量配置 ​

可以使用以下环境变量来配置 Blender 连接：

  • BLENDER_HOST：Blender 套接字服务器的主机地址（默认："localhost"）
  • BLENDER_PORT：Blender 套接字服务器的端口号（默认：9876）

示例：

bash
export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876

Hyper3D 集成 ​

Hyper3D 的免费试用密钥允许您每天生成有限数量的模型。

  • 如果达到每日限额，可以等待第二天重置
  • 或者从 hyper3d.ai 和 fal.ai 获取您自己的密钥

故障排除 ​

连接问题 ​

  • 确保 Blender 插件服务器正在运行
  • 确保 MCP 服务器已在 Claude 上配置好
  • 不要在终端中手动运行 uvx 命令
  • 有时第一个命令可能无法执行，但之后就能正常工作

超时错误 ​

  • 尝试简化请求
  • 将复杂操作拆分成更小的步骤

Poly Haven 集成 ​

  • Claude 的行为有时不稳定
  • 如果遇到问题，尝试重启 Claude 和 Blender 服务器

连接错误持续存在 ​

如果连接错误仍然存​​在，请尝试：

  1. 重启 Claude Desktop/Cursor
  2. 重启 Blender 服务器
  3. 保存工作后重启 Blender

技术细节 ​

通信协议 ​

系统使用基于 TCP 套接字的简单 JSON 协议：

  • 命令以 JSON 对象的形式发送，包含 type 和可选的 params
  • 响应是包含 status 和 result 或 message 的 JSON 对象

系统组件 ​

  1. Blender 插件（addon.py）：在 Blender 内部创建套接字服务器，用于接收和执行命令
  2. MCP 服务器（src/blender_mcp/server.py）：实现模型上下文协议并连接到 Blender 插件

局限性与安全注意事项 ​

安全警告

  • execute_blender_code 工具允许在 Blender 中运行任意 Python 代码，功能强大但也可能存在风险
  • 在生产环境中使用时务必谨慎
  • 使用前务必保存您的工作

其他注意事项 ​

  • Poly Haven 需要下载模型、纹理和 HDRI 图像。如果不想使用，请在 Blender 中取消勾选相应的复选框
  • 复杂的操作可能需要分解成更小的步骤

社区与支持 ​

  • Discord 社区：加入讨论和获取帮助
  • GitHub 仓库：siddharth7113/blender-mcp
  • 问题反馈：在 GitHub Issues 中提交

免责声明 ​

这是第三方集成，并非 Blender 官方制作。由 Siddharth 开发和维护。

相关资源 ​