搅拌机打开mcp
blender-open-mcp 是一个开源项目,将Blender与本地AI模型集成在一起(通过 奥拉玛)使用模型上下文协议(MCP)。这允许您使用自然语言提示来控制Blender,利用AI的力量来协助3D建模任务。
特性
- 用自然语言控制搅拌机: 向本地运行的Ollama模型发送提示,以在Blender中执行操作。
- MCP集成: 使用模型上下文协议在AI模型和Blender之间进行结构化通信。
- Olama支持: 旨在与Ollama合作,轻松进行本地模型管理。
- 搅拌机插件: 包括一个Blender插件,用于提供用户界面并处理与服务器的通信。
- PolyHaven集成(可选): 从下载和使用资源(HDRI、纹理、模型) PolyHaven 通过AI提示直接在Blender中。
- 基本3D操作:
- 获取场景和对象信息 - 创建基本体 - 修改和删除对象 - 应用材料
- 渲染支持: 使用该工具渲染图像,并根据输出检索信息。
安装
先决条件
- 搅拌机: Blender 3.0或更高版本。下载自 blender.org.
- 奥拉马: 从以下位置安装 ollama.com,遵循操作系统特定的说明。
- python Python 3.10或更高版本。
- 紫外线: 使用安装
pip install uv. - Git: 克隆存储库所需。
安装步骤
- 克隆存储库:
git clone https://github.com/dhakalnirajan/blender-open-mcp.git
cd blender-open-mcp- 创建和激活虚拟环境(推荐):
uv venv
source .venv/bin/activate # On Linux/macOS
.venv\Scripts\activate # On Windows- 安装依赖关系:
uv pip install -e .- 安装Blender插件:
- 打开搅拌机。 - 首选 Edit -> Preferences -> Add-ons. - 点击 Install.... - 选择 addon.py 文件来自 blender-open-mcp 目录。 - 启用“Blender MCP”插件。
- 下载Ollama Model(如果尚未安装):
ollama run llama3.2*(其他型号如 Gemma3 也可以使用。)*
设置
- 启动Open WebUI服务器:
open-webui serve- 前往“设置”>“工具”>“附加组件”,添加连接,然后输入:http://localhost:8000在URL部分,并保存。
open-webui serve- 启动MCP服务器:
blender-mcp或者,
python src/blender_open_mcp/server.py默认情况下,它会监听 http://0.0.0.0:8000,但您可以修改设置:
blender-mcp --host 127.0.0.1 --port 8001 --ollama-url http://localhost:11434 --ollama-model llama3.2- 启动Blender插件服务器:
- 打开Blender和3D视口。 - 按 N 打开侧边栏。 - 找到“搅拌机MCP”面板。 - 点击“启动MCP服务器”。
用法
与交互 blender-open-mcp 使用 mcp 命令行工具:
示例命令
- 基本提示:
mcp prompt "Hello BlenderMCP!" --host http://localhost:8000- 获取场景信息:
mcp tool get_scene_info --host http://localhost:8000- 创建多维数据集:
mcp prompt "Create a cube named 'my_cube'." --host http://localhost:8000- 渲染图像:
mcp prompt "Render the image." --host http://localhost:8000- 使用PolyHaven(如果启用):
mcp prompt "Download a texture from PolyHaven." --host http://localhost:8000可用工具
| 工具名称 | 描述 | 参数 |
|---|---|---|
get_scene_info | 检索场景详细信息。 | 无 |
get_object_info | 检索有关对象的信息。 | object_name (str) |
create_object | 创建三维对象。 | type, name, location, rotation, scale |
modify_object | 修改对象的属性。 | name, location, rotation, scale, visible |
delete_object | 删除对象。 | name (str) |
set_material | 将材质指定给对象。 | object_name, material_name, color |
render_image | 渲染图像。 | file_path (str) |
execute_blender_code | 在Blender中执行Python代码。 | code (str) |
get_polyhaven_categories | 列出PolyHaven资产类别。 | asset_type (str) |
search_polyhaven_assets | 搜索PolyHaven资产。 | asset_type, categories |
download_polyhaven_asset | 下载PolyHaven资产。 | asset_id, asset_type, resolution, file_format |
set_texture | 应用下载的纹理。 | object_name, texture_id |
set_ollama_model | 设置Ollama模型。 | model_name (str) |
set_ollama_url | 设置Ollama服务器URL | url (str) |
get_ollama_models | 列出可用的Olama型号。 | 无 |
故障排除
如果您遇到问题:
- 确保Olama和
blender-open-mcp服务器正在运行。 - 检查Blender的附加设置。
- 验证命令行参数。
- 有关错误详细信息,请参阅日志。
如需更多帮助,请访问 页面。
______________________________________________________________________
快乐与AI融合! 🚀
