基本能力
产品定位
BlenderMCP 是一个连接 Blender 和 Claude AI 的工具,通过 MCP 协议实现双向通信,支持通过 AI 提示进行 3D 建模和场景操作。
核心功能
- 双向通信:通过基于套接字的服务器连接 Claude AI 和 Blender
- 对象操作:创建、修改和删除 3D 对象
- 材质控制:应用和修改材质和颜色
- 场景检查:获取当前 Blender 场景的详细信息
- 代码执行:从 Claude 运行任意 Python 代码
适用场景
- 通过 AI 提示快速生成 3D 场景
- 自动化 3D 建模任务
- 通过 AI 辅助进行复杂的 3D 操作
工具列表
- Blender Addon (
addon.py
):在 Blender 中创建套接字服务器以接收和执行命令 - MCP Server (
src/blender_mcp/server.py
):实现 MCP 协议并连接到 Blender 插件
常见问题解答
- 连接问题:确保 Blender 插件服务器正在运行,且 MCP 服务器已在 Claude 中配置
- 超时错误:尝试简化请求或将其分解为更小的步骤
- Poly Haven 集成:Claude 的行为有时不稳定
使用教程
使用依赖
- Blender 3.0 或更新版本
- Python 3.10 或更新版本
- uv 包管理器
Mac 安装 uv
bash
brew install uv
Windows 安装 uv
bash
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
set Path=C:\Users\nntra\.local\bin;%Path%
安装教程
- 下载
addon.py
文件 - 打开 Blender
- 转到 Edit > Preferences > Add-ons
- 点击 "Install..." 并选择
addon.py
文件 - 启用插件
调试方式
- 在 Blender 中,转到 3D View 侧边栏
- 找到 "BlenderMCP" 选项卡
- 点击 "Connect to Claude"
- 确保 MCP 服务器在终端中运行