适合谁
- 3D 艺术家和建模师，希望通过自然语言与 Blender 交互并提高工作效率。
- 开发者希望将 Blender 集成到 AI 工作流中。
B
59FMRS · C
BlenderMCP 是一个功能丰富的开源项目，为 LLM 与 Blender 交互提供了强大桥梁，受到社区欢迎。其亮点包括多种外部资源集成和双机通信，但存在任意代码执行的安全隐患，用户需谨慎使用。
BlenderMCP 是一个开源项目，通过模型上下文协议（MCP）将 Blender 连接到 Claude AI，使 Claude 能够直接操控 Blender。它支持场景创建、对象操作、材质控制、Python 代码执行等功能。该服务器由两部分组成：Blender 插件（addon.py）创建套接字服务器，以及 MCP Python 服务器。工具集包括获取场景/对象信息、创建/修改/删除对象、应用材质、执行任意 Python 代码，甚至集成 Sketchfab、Poly Haven 和 Hyper3D 等外部资源。安装要求 Blender 3.0+、Python 3.10+ 和 uv 包管理器。
工具能力
Get Scene Info
获取当前 Blender 场景的详细信息。
Get Object Info
获取指定对象的属性信息。
Create Object
在场景中创建新的 3D 对象。
Modify Object
修改现有对象的位置、旋转、缩放等属性。
Delete Object
删除场景中的对象。
Apply Material
为对象应用现有材质。
Create Material
创建新材质并设置颜色等属性。
Execute Blender Code
在 Blender 中执行任意 Python 代码（高风险）。
Search Sketchfab
在 Sketchfab 上搜索 3D 模型。
Download Sketchfab Model
下载 Sketchfab 模型到 Blender 场景。
Load Poly Haven Asset
从 Poly Haven API 加载模型、纹理或 HDRI。
Generate Hyper3D Model
通过 Hyper3D Rodin API 生成 3D 模型。
Generate Hunyuan3D Model
通过 Hunyuan3D API 生成 3D 模型。
Capture Screenshot
捕获 Blender 视口的截图以了解场景。
安装接入
- 安装 Blender 3.0 或更高版本。
- 安装 Python 3.10+ 和 uv 包管理器。
- 从仓库下载 addon.py 文件，在 Blender 中通过 Edit > Preferences > Add-ons > Install... 安装并启用它。
- 在 Claude Desktop 的 claude_desktop_config.json 中添加 MCP 服务器配置，使用 uvx 运行 blender-mcp。
- 在 Blender 中，打开 3D 视图侧边栏（按 N），找到 'BlenderMCP' 选项卡，点击 'Connect to Claude'。
- 确保 MCP 服务器在客户端中运行。
claude_desktop_config.json
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["--python", "3.11", "blender-mcp"],
"env": { "UV_PYTHON_PREFERENCE": "only-managed" }
}
}
}
选型与风险
不适合谁
- 不适合需要严格安全控制的自动化环境，因为 execute_blender_code 允许任意代码执行。
- 不适合需要可靠实时渲染或复杂动画的用户，因为工具主要面向场景创建和修改。
所需权限
- 允许 MCP 服务器网络访问 Blender 套接字端口（默认 9876）。
- 允许执行任意 Python 代码，这可访问文件系统和其他系统资源。
- 外部 API 密钥（Sketchfab、Hyper3D、Hunyuan3D）用于资源下载和模型生成。
风险与副作用
- execute_blender_code 工具可以运行任意代码，可能导致数据丢失或系统损坏。使用前务必保存工作。
- Poly Haven 集成可能下载大量资源，消耗带宽和存储。
- 远程运行时，网络连接可能暴露。
- 第三方 API 可能有使用限制或费用。
常见排障
- 连接问题：确保 Blender 插件已启用并点击 'Connect to Claude'，MCP 服务器在客户端中配置正确，不要手动运行 uvx 命令。
- 超时错误：简化请求或分解步骤。
- PATH 问题：确保客户端能找到 uvx 的完整路径，或使用 cmd /c 包装。
- Python 版本冲突：使用 --python 3.11 和 UV_PYTHON_PREFERENCE=only-managed。
- 重启客户端和服务器：完全退出并重新启动。
使用场景
让 Claude 根据文本提示创建复杂的 3D 场景，如 '在 dungeon 中创建 low poly 场景，有龙守护一罐金子'。
从参考图像生成 Blender 场景。
使用 Poly Haven 资源（HDRI、纹理、模型）创建海滩氛围。
通过 Hyper3D 或 Hunyuan3D 生成 AI 3D 模型。
修改现有场景的材质和灯光。
支持客户端
Claude Desktop完整支持