BlenderMCP - Blender Model Context Protocol Integration

基本能力

产品定位

BlenderMCP 是一个连接 Blender 和 Claude AI 的工具，通过 MCP 协议实现双向通信，支持通过 AI 提示进行 3D 建模和场景操作。

核心功能

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

适用场景

• 通过 AI 提示快速生成 3D 场景
• 自动化 3D 建模任务
• 通过 AI 辅助进行复杂的 3D 操作

工具列表

1. Blender Addon (addon.py)：在 Blender 中创建套接字服务器以接收和执行命令
2. MCP Server (src/blender_mcp/server.py)：实现 MCP 协议并连接到 Blender 插件

常见问题解答

• 连接问题：确保 Blender 插件服务器正在运行，且 MCP 服务器已在 Claude 中配置
• 超时错误：尝试简化请求或将其分解为更小的步骤
• Poly Haven 集成：Claude 的行为有时不稳定

使用教程

使用依赖

• Blender 3.0 或更新版本
• Python 3.10 或更新版本
• uv 包管理器

Mac 安装 uv

brew install uv

Windows 安装 uv

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
set Path=C:\Users\nntra\.local\bin;%Path%

安装教程

1. 下载 addon.py 文件
2. 打开 Blender
3. 转到 Edit > Preferences > Add-ons
4. 点击 "Install..." 并选择 addon.py 文件
5. 启用插件

调试方式

1. 在 Blender 中，转到 3D View 侧边栏
2. 找到 "BlenderMCP" 选项卡
3. 点击 "Connect to Claude"
4. 确保 MCP 服务器在终端中运行

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。