Blender MCP服务

一个基于Python的模型上下文协议(MCP)服务器,用于将Blender和3D建模能力与OpenClaw AI代理集成。

  • by tinhtinhcd
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tinhtinhcd/mcp-blender-server

使用说明

mcp搅拌机服务器

基于Python的模型上下文协议(MCP)服务器,用于将Blender和3D建模功能与OpenClaw AI代理集成。该项目旨在适应和部署 blender-mcp 作为我们AI漫画工作室第二阶段开发的专用MCP服务器。

免责声明: 这是对原作的改编 blender-mcp 项目。我们与原件没有正式联系 blender-mcp 项目或其维护者。

特性

  • 搅拌机控制: 与Blender交互以创建、修改和删除3D对象、控制材质和检查场景。
  • 人工智能驱动的3D一代: 与Hunyuan3D和Hyper3D Rodin等AI 3D生成工具集成(通过其API)。
  • 资产管理: 从Sketchfab下载模型,从Poly Haven下载资产。
  • Python代码执行: 在Blender中执行任意Python代码。

组件

该项目将改编并包含以下原始核心组件 blender-mcp:

  1. 搅拌机插件(addon.py): Blender插件,在Blender中创建套接字服务器以接收和执行命令。(将放置在此仓库的根目录中,以便于访问)
  2. MCP服务器(src/blender_mcp/server.py): 实现模型上下文协议并连接到Blender插件的Python服务器。

安装和设置(本地开发)

先决条件

  • 搅拌机3.0或更新版本
  • Python 3.10或更新版本
  • uv 包管理器(建议用于依赖关系管理)

环境设置

  1. 克隆存储库:
    git clone https://github.com/tinhtinhcd/mcp-blender-server
    cd mcp-blender-server
    
  2. 安装 uv (如果尚未安装):
    curl -LsSf https://astral.sh/uv/install.sh | sh
    export PATH="$HOME/.local/bin:$PATH" # Add uv to PATH for current session
    
  3. 创建虚拟环境并安装依赖项:
    uv venv
    source ./.venv/bin/activate # Activate the virtual environment
    uv pip install "mcp[cli]>=1.3.0" "supabase>=2.0.0" "tomli>=2.0.0"
    
    (注:原始版本的其他依赖项 blender-mcp 可以根据需要添加项目。)

运行MCP服务器

要运行MCP服务器,请执行以下操作:

uvx mcp-blender-server

(确保你的Blender插件也在运行并连接。)

与OpenClaw人工智能代理集成

此服务器将配置为OpenClaw AI代理的MCP服务器。AI代理将向此服务器发送命令,以控制Blender并管理3D资产。

贡献

欢迎投稿!请随时提交拉取请求。