AI导哈

Blender AI集成工具

BlenderMCP通过Model Context Protocol（MCP）将Blender与Claude AI连接，实现AI辅助3D建模、场景创建和对象操作。

  • by drrodingo-del
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 drrodingo-del/blender-mcp

使用说明

BlenderMCP - Blender模型上下文协议集成

BlenderMCP通过模型上下文协议（MCP）将Blender与Claude AI连接起来，使Claude能够直接与Blender进行交互和控制。这种集成支持提示辅助的3D建模、场景创建和操作。

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

完整教程

加入社区

提供反馈，获取灵感，并在MCP的基础上进行拓展： Discord（迪斯科德，通常直接音译为“迪斯科德”或简化为“Discord”，在中文语境中常直接使用原名）

支持者

CodeRabbit（代码兔子）

萨蒂什·戈达

所有支持者：

支持这个项目

发布说明（1.2.0）

  • 查看Blender视口的截图，以便更好地理解场景
  • 搜索并下载Sketchfab模型

之前添加的功能：

  • 通过其API支持Poly Haven的资源
  • 支持使用Hyper3D Rodin生成3D模型
  • 对于新用户，您可以直接跳转到安装步骤。对于现有用户，请参阅以下要点
  • 下载最新的addon.py文件并替换旧的文件，然后将其添加到Blender中
  • 从Claude中删除MCP服务器，然后重新添加它，之后应该就可以正常使用了！

特点/特性

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

组件

该系统由两个主要部分组成：

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

安装

先决条件

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

如果你使用的是Mac，请安装uv作为

brew install uv

在Windows上

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

然后

set Path=C:\Users\nntra\.local\bin;%Path%

否则，安装说明请参见他们的网站： 安装 uv

⚠️ 未安装紫外线灯前请勿继续操作

环境变量

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

  • BLENDER_HOSTBlender 套接字服务器的主机地址（默认：“localhost”）
  • BLENDER_PORTBlender 套接字服务器的端口号（默认：9876）

示例：

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

Claude桌面集成版

观看安装说明视频 （假设你已经安装了uv）

前往 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，然后添加以下内容：

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

光标集成

对于Mac用户，请前往“设置”>“MCP”并粘贴以下内容

  • 要将其用作全局服务器，请使用“添加新的全局MCP服务器”按钮并粘贴
  • 要将其用作特定项目的服务器，请创建 .cursor/mcp.json 在项目的根目录下并粘贴
{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

对于Windows用户，请前往“设置”>“MCP”>“添加服务器”，并使用以下设置添加一个新服务器：

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

光标设置视频

⚠️ 请仅运行一个MCP服务器实例（要么在Cursor上，要么在Claude Desktop上），不要同时运行两者

Visual Studio Code 集成

_先决条件_确保你已经 Visual Studio Code 在继续之前请先安装。

安装Blender插件

  1. 下载该 addon.py 来自此仓库的文件
  2. 打开Blender
  3. 进入“编辑”>“首选项”>“附加组件”
  4. 点击“安装...”并选择 addon.py 文件
  5. 通过勾选“Interface: Blender MCP”旁边的框来启用该插件

使用

开始连接

  1. 在Blender中，转到3D视图侧边栏（如果不可见，请按N键）
  2. 找到“BlenderMCP”选项卡
  3. 如果想从他们的API获取资源，请勾选Poly Haven复选框（可选）
  4. 点击“连接到Claude”
  5. 确保您的终端中MCP服务器正在运行

与Claude一起使用

一旦在Claude上设置了配置文件，并且插件在Blender中运行，您就会看到一个带有Blender MCP工具的锤子图标。

能力

  • 获取场景和对象信息
  • 创建、删除和修改形状
  • 为物体应用或创建材料
  • 在Blender中执行任意Python代码
  • 通过以下方式下载合适的模型、资源和HDR图像： 波利海文
  • 通过人工智能生成的3D模型 Hyper3D Rodin

示例命令

以下是一些你可以让Claude帮忙做的事情的例子：

  • “在地牢中创建一个低多边形场景，由一条龙守护着一罐黄金” 演示
  • “利用HDR环境贴图、纹理以及来自Poly Haven的岩石和植被等模型，营造出海滩的氛围” 演示
  • 提供一个参考图像，并基于它创建一个Blender场景 演示
  • “通过Hyper3D生成一个花园地精的3D模型”
  • “获取当前场景的信息，并据此创建一个Three.js草图” 演示
  • “把这辆车涂成红色且带金属质感”
  • “创建一个球体并将其放置在立方体上方”
  • “让灯光效果像摄影棚一样”
  • “将相机对准场景，并设置为等距视角”

Hyper3D集成

Hyper3D的免费试用密钥允许您每天生成有限数量的模型。如果达到每日上限，您可以等待次日重置，或者从hyper3d.ai和fal.ai获取您自己的密钥。

故障排除

  • 连接问题确保Blender插件服务器正在运行，并且MCP服务器已在Claude上配置好，不要在终端中运行uvx命令。有时，第一个命令可能无法执行，但之后它就会开始工作。
  • 超时错误尝试简化你的要求或将它们分解成更小的步骤
  • Poly Haven 集成克劳德的行为有时会很不稳定
  • **你有没有试过把它关掉再打开？**如果你仍然遇到连接错误，请尝试重启Claude和Blender服务器

技术细节

通信协议

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

  • 命令 以JSON对象的形式发送，其中包含一个 type 以及可选的 params
  • 回应 是带有（某些属性或方法的）JSON对象 status 并且 result 或者 message

限制与安全考量

  • 这个（或“该”） execute_blender_code 该工具允许在Blender中运行任意Python代码，这功能强大但可能带来风险。在生产环境中使用时请务必谨慎。使用前请务必保存您的工作。
  • Poly Haven 需要下载模型、纹理和HDRI图像。如果您不想使用它，请在Blender中的复选框里将其关闭。
  • 复杂的操作可能需要分解为更小的步骤

做出贡献

欢迎贡献！请随时提交拉取请求。

免责声明

这是一个第三方集成，并非由Blender制作。由……制作 罗丁戈

相关 MCP