项目简介

Blender-MCP-Server是一个功能完整的Blender插件,实现了Model Context Protocol服务器,允许AI代理通过标准化协议控制Blender的各个方面,包括建模、材质、灯光、动画和渲染等50+种专业功能。

主要功能

  • 3D建模控制:创建和编辑网格、曲线、文本等基本几何体
  • 高级特效系统:粒子系统、流体模拟、刚体物理和布料仿真
  • 几何节点系统:支持程序化建模和复杂几何操作
  • 材质与着色:创建PBR材质、程序化纹理和复杂着色网络
  • 动画系统:关键帧动画、骨骼绑定和运动控制
  • 渲染引擎集成:支持Cycles和EEVEE渲染器配置
  • 批量操作:支持多对象同时创建和变换
  • 空间感知:为VLM提供视口捕捉、空间布局分析和操作验证
  • 文件与数据管理:支持多种格式的导入导出
  • 线程安全执行:确保在多线程环境下的稳定运行

安装步骤

  1. 从GitHub Releases页面下载最新版本的Blender-MCP-Server
  2. 打开Blender,进入编辑菜单→偏好设置→插件
  3. 点击安装,选择下载的插件文件
  4. 启用插件复选框激活功能
  • 依赖包自动安装:首次运行时会自动安装所需的Python包

服务器配置

该MCP服务器通过HTTP协议运行在本地端口8000上,支持以下配置参数:

  • 服务器类型:FastAPI Web服务器
  • 启动命令:通过Blender界面启动服务器
  1. 连接地址:http://localhost:8000
  2. 协议支持:完整的JSON-RPC MCP协议实现
  3. 传输协议:支持HTTP/WebSocket通信
  4. 工具注册:51个专业工具已注册为MCP端点

基本使用方法

  1. 在Blender的3D视图侧边栏中找到MCP Server面板
  2. 点击"Start Server"启动MCP服务
  3. 配置MCP客户端连接到 http://localhost:8000/mcp
  4. 通过API文档(http://localhost:8000/docs)查看完整接口文档
  5. 使用AI代理通过标准MCP协议调用Blender功能
  6. 支持工具编排、自动依赖安装和线程安全操作

兼容性信息

  • Blender版本:3.0或更高
  • 操作系统:Windows 10+、macOS Catalina+、主流Linux发行版

信息

分类

桌面与硬件