适合谁
- 希望用本地AI模型控制Blender的3D艺术家
- 需要自动化3D工作流的开发者
- 集成Claude Desktop或Cursor进行AI辅助建模的用户
B
40FMRS · D
该服务器提供了一个实用的MCP集成，通过本地Ollama模型实现自然语言控制Blender，适合开发者和3D艺术家。其架构清晰，工具丰富，包括场景操作、材质、渲染和AI辅助。但执行任意代码和删除对象的功能带来安全风险，需谨慎使用。非官方项目，依赖本地模型，不适合需要云AI或低安全风险的用户。
基于模型上下文协议（MCP）构建，将Claude、Cursor或任何MCP客户端通过本地Ollama LLM连接到Blender。使用FastMCP服务器、Blender插件和Ollama实现架构。
工具能力
blender_get_scene_info
获取完整场景摘要：对象、相机、渲染设置
blender_get_object_info
获取详细对象信息：变换、材质、网格统计
blender_create_object
添加基本网格（立方体、球体、圆柱体等）
blender_modify_object
更改位置、旋转、缩放、可见性
blender_delete_object
从场景中删除对象
blender_set_material
创建并分配原理化BSDF材质
blender_render_image
将当前场景渲染到文件
blender_execute_code
在Blender中运行任意Python/bpy代码
blender_get_polyhaven_categories
列出PolyHaven资源类别
blender_search_polyhaven_assets
搜索PolyHaven库并分页
blender_download_polyhaven_asset
下载并导入PolyHaven资源
blender_set_texture
将下载的PolyHaven纹理应用到对象
blender_ai_prompt
向Ollama发送自然语言提示
blender_get_ollama_models
列出可用的本地Ollama模型
blender_set_ollama_model
切换当前Ollama模型
blender_set_ollama_url
更新Ollama服务器URL
安装接入
- 安装依赖：Blender 3.0+，Python 3.10+，Ollama，uv。
- 克隆仓库并设置虚拟环境：
uv venv，激活，uv pip install -e .。 - 在Blender中安装插件：编辑→偏好设置→插件→安装，选择
addon.py，启用“Blender MCP”，在3D视口N侧边栏启动MCP服务器（默认端口9876）。 - 拉取Ollama模型：
ollama pull ollama run llama3.2。 - 启动Ollama服务器。
- 启动MCP服务器：
blender-mcp，或使用自定义选项，如--transport stdio。
claude_desktop_config.json
{
"mcpServers": {
"blender-open-mcp": {
"command": "blender-mcp",
"args": ["--transport", "stdio"]
}
}
}
选型与风险
不适合谁
- 没有本地Ollama或无法运行本地LLM的用户
- 需要云AI服务的用户（因为使用本地模型）
- 不熟悉Blender插件安装的用户
- 需要官方支持的用户（非官方项目）
所需权限
- 能读取和修改Blender场景（对象、材质、变换）
- 能执行任意Python/bpy代码（通过blender_execute_code）
- 能删除对象（blender_delete_object）
- 能渲染图像到文件
- 能访问互联网以下载PolyHaven资源
- 能通过Ollama访问本地模型
- 需要网络端口（8000、9876、11434）
风险与副作用
- 执行任意代码可能损坏场景或系统，如果提供了恶意提示
- 删除对象操作不可逆，可能丢失工作
- PolyHaven下载需要互联网连接，可能失败
- 本地LLM可能产生不准确的代码，需要检查后执行
- 非官方项目，可能存在bug或安全漏洞
常见排障
- 无法连接Blender插件：在Blender侧边栏启动MCP服务器
- 无法连接Ollama：运行`ollama serve`
- 对象未找到：使用`blender_get_scene_info`检查确切名称
- 渲染失败：确保输出目录存在且可写
- PolyHaven下载失败：检查网络连接，尝试较低分辨率
使用场景
通过自然语言命令在Blender中创建和修改3D对象
使用AI助手生成和执行bpy代码
从PolyHaven下载并应用纹理
自动渲染场景
获取场景和对象信息以供AI分析
支持客户端
Claude Desktop完整支持
Cursor完整支持