BlenderMCP - Blender模型上下文协议集成
BlenderMCP通过模型上下文协议（MCP）将Blender与Claude AI连接起来，使Claude能够直接与Blender交互并进行控制。这种集成实现了提示辅助的3D建模、场景创建和操作。
我们没有官方网站。您在网上看到的任何网站均非官方，且与本项目无关。使用时请自行承担风险。
加入社区
提供反馈，获取灵感，并在MCP的基础上进行拓展： Discord（音译：迪斯科德，或根据语境可译为“迪斯科聊天软件”等，但通常直接使用“Discord”这一名称）
支持者
Special thanks to:
Warp，面向开发者的智能终端
其他支持者：
代码兔子（或译为“代码兔”，根据上下文，“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代码
组件
该系统由两个主要组件构成：
- Blender 插件
addon.py)一个Blender插件，用于在Blender内部创建一个套接字服务器以接收并执行命令 - 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
⚠️ 安装UV之前请勿继续操作
环境变量
以下环境变量可用于配置Blender连接：
BLENDER_HOSTBlender 套接字服务器的主机地址（默认：“localhost”）BLENDER_PORTBlender 套接字服务器的端口号（默认：9876）
示例：
export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876Claude桌面集成版
观看安装说明视频 （假设您已经安装了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"
]
}
}
}⚠️ 仅在Cursor或Claude Desktop中运行一个MCP服务器实例，不要同时运行两者
Visual Studio Code 集成
_先决条件_确保你已 Visual Studio Code 在继续之前请先安装。
安装Blender插件
- 下载该
addon.py来自这个仓库的文件 - 打开Blender
- 进入“编辑”>“首选项”>“附加组件”
- 点击“安装...”并选择
addon.py文件 - 通过勾选“界面：Blender MCP”旁边的复选框来启用该插件
用法
开始连接
- 在Blender中，前往3D视图侧边栏（如未显示，请按N键）
- 找到“BlenderMCP”选项卡
- 如果您想从他们的API获取资源，请勾选Poly Haven复选框（可选）
- 点击“连接到Claude”
- 确保MCP服务器在您的终端中正在运行
与Claude一起使用
一旦在Claude上设置了配置文件，并且插件在Blender中运行，您将看到一个带有Blender MCP工具的锤子图标。
能力
- 获取场景和物体信息
- 创建、删除和修改形状
- 为物体应用或创建材质
- 在Blender中执行任何Python代码
- 下载正确的模型、资源和HDR图像 波利海文
- 通过AI生成3D模型 Hyper3D Rodin（可译为“超3D罗丹”或根据具体语境调整，但“罗丹”在此处可能是一个特定名称或品牌，直接保留原样更符合中文表达习惯）
示例命令
以下是一些你可以让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制作。由……制作 西达尔特（人名）