blender-open-mcp

blender-open-mcp是一个开源项目，它使用模型上下文协议 (MCP) 将 Blender 与本地 AI 模型（通过Ollama ）集成。这允许您使用自然语言提示来控制 Blender，利用 AI 的强大功能来协助完成 3D 建模任务。

特征

Related MCP server: SupaUI MCP Server

克隆存储库：
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 插件：
- 打开 Blender。
- 转到Edit -> Preferences -> Add-ons 。
- 单击Install... 。
- 从blender-open-mcp目录中选择addon.py文件。
- 启用“Blender MCP”插件。
下载 Ollama 模型（如果尚未安装）：
ollama run llama3.2
（也可以使用*Gemma3*等其他模型。）

**启动 Ollama 服务器：**确保 Ollama 在后台运行。
启动 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打开侧边栏。
- 找到“Blender MCP”面板。
- 点击“启动 MCP 服务器”。

使用mcp命令行工具与blender-open-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` （字符串）
`create_object`	创建一个 3D 对象。	`type` 、 `name` 、 `location` 、 `rotation` 、 `scale`
`modify_object`	修改对象的属性。	`name` 、 `location` 、 `rotation` 、 `scale` 、 `visible`
`delete_object`	删除一个对象。	`name` （字符串）
`set_material`	为对象指定材质。	`object_name` 、 `material_name` 、 `color`
`render_image`	渲染图像。	`file_path` （字符串）
`execute_blender_code`	在 Blender 中执行 Python 代码。	`code` （字符串）
`get_polyhaven_categories`	列出 PolyHaven 资产类别。	`asset_type` （字符串）
`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` （字符串）
`set_ollama_url`	设置 Ollama 服务器 URL。	`url` （字符串）
`get_ollama_models`	列出可用的 Ollama 模型。	没有任何