项目简介
Blender-MCP-Server是一个功能完整的Blender插件,实现了Model Context Protocol服务器,允许AI代理通过标准化协议控制Blender的各个方面,包括建模、材质、灯光、动画和渲染等50+种专业功能。
主要功能
- 3D建模控制:创建和编辑网格、曲线、文本等基本几何体
- 高级特效系统:粒子系统、流体模拟、刚体物理和布料仿真
- 几何节点系统:支持程序化建模和复杂几何操作
- 材质与着色:创建PBR材质、程序化纹理和复杂着色网络
- 动画系统:关键帧动画、骨骼绑定和运动控制
- 渲染引擎集成:支持Cycles和EEVEE渲染器配置
- 批量操作:支持多对象同时创建和变换
- 空间感知:为VLM提供视口捕捉、空间布局分析和操作验证
- 文件与数据管理:支持多种格式的导入导出
- 线程安全执行:确保在多线程环境下的稳定运行
安装步骤
- 从GitHub Releases页面下载最新版本的Blender-MCP-Server
- 打开Blender,进入编辑菜单→偏好设置→插件
- 点击安装,选择下载的插件文件
- 启用插件复选框激活功能
- 依赖包自动安装:首次运行时会自动安装所需的Python包
服务器配置
该MCP服务器通过HTTP协议运行在本地端口8000上,支持以下配置参数:
- 服务器类型:FastAPI Web服务器
- 启动命令:通过Blender界面启动服务器
- 连接地址:http://localhost:8000
- 协议支持:完整的JSON-RPC MCP协议实现
- 传输协议:支持HTTP/WebSocket通信
- 工具注册:51个专业工具已注册为MCP端点
基本使用方法
- 在Blender的3D视图侧边栏中找到MCP Server面板
- 点击"Start Server"启动MCP服务
- 配置MCP客户端连接到 http://localhost:8000/mcp
- 通过API文档(http://localhost:8000/docs)查看完整接口文档
- 使用AI代理通过标准MCP协议调用Blender功能
- 支持工具编排、自动依赖安装和线程安全操作
兼容性信息
- Blender版本:3.0或更高
- 操作系统:Windows 10+、macOS Catalina+、主流Linux发行版
信息
分类
桌面与硬件