local-only server

The server can only run on the client’s local machine because it depends on local resources.

Enables control of Blender using natural language prompts, allowing for 3D modeling tasks such as creating and modifying objects, applying materials, and rendering images through a Blender add-on that handles communication with the server.
Uses locally running Ollama models to process natural language commands, with the ability to switch between different models like llama3.2 or Gemma3, and query available models from the Ollama server.

blender-open-mcp

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

特征

克隆存储库：
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 模型。	没有任何

如果您遇到问题：

如需进一步帮助，请访问GitHub 问题页面。

祝您与 AI 愉快融合！🚀

-

security - not tested

F

license - not found

-

quality - not tested

通过模型上下文协议将 Blender 与本地 AI 模型集成的服务器，允许用户使用自然语言提示来控制 Blender 执行 3D 建模任务。