AI导哈

Blender自然语言控制工具

blender-open-mcp是一个开源项目，通过Model Context Protocol (MCP)将Blender与本地AI模型（通过Ollama）集成，允许用户使用自然语言提示控制Blender，辅助完成3D建模任务。

  • by EeWeiLi
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 EeWeiLi/Blender-OpenWebUI-MCP

使用说明

搅拌机打开mcp

blender-open-mcp 是一个开源项目，将Blender与本地AI模型集成在一起（通过 奥拉玛)使用模型上下文协议（MCP）。这允许您使用自然语言提示来控制Blender，利用AI的力量来协助3D建模任务。

特性

  • 用自然语言控制搅拌机： 向本地运行的Ollama模型发送提示，以在Blender中执行操作。
  • MCP集成： 使用模型上下文协议在AI模型和Blender之间进行结构化通信。
  • Olama支持： 旨在与Ollama合作，轻松进行本地模型管理。
  • 搅拌机插件： 包括一个Blender插件，用于提供用户界面并处理与服务器的通信。
  • PolyHaven集成（可选）： 从下载和使用资源（HDRI、纹理、模型） PolyHaven 通过AI提示直接在Blender中。
  • 基本3D操作：
    • 获取场景和对象信息
    • 创建基本体
    • 修改和删除对象
    • 应用材料
  • 渲染支持： 使用该工具渲染图像，并根据输出检索信息。

安装

先决条件

  1. 搅拌机： Blender 3.0或更高版本。下载自 blender.org.
  2. 奥拉马： 从以下位置安装 ollama.com，遵循操作系统特定的说明。
  3. python Python 3.10或更高版本。
  4. 紫外线： 使用安装 pip install uv.
  5. Git： 克隆存储库所需。

安装步骤

  1. 克隆存储库：

    git clone https://github.com/dhakalnirajan/blender-open-mcp.git
cd blender-open-mcp

  2. 创建和激活虚拟环境（推荐）：

    uv venv
source .venv/bin/activate  # On Linux/macOS
.venv\Scripts\activate  # On Windows

  3. 安装依赖关系：

    uv pip install -e .

  4. 安装Blender插件：

    • 打开搅拌机。
    • 首选 Edit -> Preferences -> Add-ons.
    • 点击 Install....
    • 选择 addon.py 文件来自 blender-open-mcp 目录。
    • 启用“Blender MCP”插件。

  5. 下载Ollama Model（如果尚未安装）：

    ollama run llama3.2

    （其他型号如 Gemma3 也可以使用。)

设置

  1. 启动Open WebUI服务器：

    open-webui serve

  2. 前往“设置”>“工具”>“附加组件”，添加连接，然后输入：http://localhost:8000在URL部分，并保存。

    open-webui serve

  3. 启动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

  4. 启动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的附加设置。
  • 验证命令行参数。
  • 有关错误详细信息，请参阅日志。

如需更多帮助，请访问 GitHub问题 页面。

快乐与AI融合！ 🚀

相关 MCP