blender-ue-bridge
Provides comprehensive control over Blender for 3D modeling, including macro-level tools for creating walls, roofs, doors, windows, staircases, furniture, and complete house workflows, plus atomic operations like extrusion, beveling, and boolean modifiers, with mesh quality validation and measurement capabilities.
Enables management of Unreal Engine scenes and assets, including spawning and transforming actors, creating and compiling Blueprints, applying materials, and transferring models from Blender, as well as generating complex scenes such as towns, castles, and mazes.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@blender-ue-bridge建一栋中世纪房屋,检查网格质量并导出到UE"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Blender↔UE Bridge v2
AI 驱动的 Blender ↔ Unreal Engine 全流程桥接系统,通过 MCP 协议统一控制两个引擎。
v2 核心升级(对比 v1):
✅ 自带 Blender Addon(零依赖,线程安全)— 不再依赖外部 MCP 插件
✅ 分层工具:宏层(墙/屋顶/门窗/楼梯)→ 原子层 → 验证层 → 视觉层
✅ 真实拓扑建模:墙壁门窗开洞为四边面构造,非堆叠方块
✅ 网格质量检查:非流形边/孤立顶点/零面积面/质量评分
✅ 测量与断言:距离/间隙/对齐/接触验证
✅ AI 动画层:关键帧/约束/刚体物理/相机运镜(环绕/推拉/转盘)/多帧视觉验证/渲染
✅ 7 个专家提示词:拓扑/尺度/PBR 材质/灯光/自审/动画工作流
✅ 线程安全协议:长度前缀 JSON + 主线程队列 + 大操作直连
✅ 83 个 MCP 工具(v1 为 27 个)
架构
Claude Code / AI Client
│
▼ (MCP stdio)
┌─────────────────────────┐
│ Blender↔UE Bridge │
│ MCP Server (FastMCP) │
├────────────┬────────────┤
│ Blender │ UE │
│ Client │ Client │ ← JSON over TCP
└──────┬─────┴──────┬─────┘
│ TCP:9876 │ TCP:55557
▼ ▼
┌──────────────┐ ┌──────────┐
│ blender_addon│ │ Unreal │
│ (Blender 插件)│ │ MCP 插件 │
│ 线程安全队列 │ │ │
└──────────────┘ └──────────┘Blender 通信协议:4 字节大端长度头 + UTF-8 JSON
常规命令:入队 → 返回排号 → 客户端轮询(主线程安全)
大操作(导出/烘焙):标记
large→ 专用线程执行 → 直接回写自动重试:addon 重启后可自动恢复连接
Related MCP server: BlenderMCP
安装
前置要求
Python 3.11+
Blender 4.0+(只装了
bpy就够 — addon 零依赖)Unreal Engine 5.3+(UnrealMCP 插件已启用)
步骤
安装 Blender Addon:
cd blender-ue-bridge
python scripts/install_addon.py # 自动检测 Blender 版本目录
# 或指定: python scripts/install_addon.py --blender-version 4.2
# 或打包: python scripts/install_addon.py --zip blender_addon.zip然后在 Blender 中启用:编辑 > 偏好设置 > 插件 > 搜索 "BlenderUE Bridge" > 勾选。 启用后 Sidebar 右侧出现 "Bridge" 面板显示服务器状态。
安装 MCP 依赖:
pip install mcp fastmcp配置 Claude Code MCP:
python scripts/setup_mcp.py install测试连接:
python scripts/test_bridge.py # 端到端测试 (需 Blender 运行中)
python scripts/test_protocol.py # 协议层测试 (无需 Blender)演示:
python scripts/demo_precision.py # 精确建模演示 (中世纪村庄)
python scripts/demo_precision.py --to-ue # 构建后导入 UEMCP 工具总览 (62 个)
宏层 — LLM 首选(任务级,已验证拓扑)
工具 | 说明 |
| 墙壁(真实门窗开洞,全四边面) |
| 屋顶(gable/hip/flat/pyramid,带挑檐) |
| 门(框+扇+把手)/ 窗(框+玻璃+竖棂+窗台) |
| 楼梯(单一网格,全四边面) |
| 家具 |
| 柱(柱身+柱头+柱基) |
| 程序化自然资产 |
| 完整房屋工作流(墙开洞+门+窗+屋顶+烟囱+斜切+材质) |
原子层(精确控制)
工具 | 说明 |
| 精确尺寸几何体(米) |
| 变换 / 原点(bottom/center/top) |
| 挤出 / 内缩 |
| 环切 / 斜切 |
| 布尔(union/difference/intersect) |
| bevel/solidify/subdivision/mirror/... |
| PBR 材质 |
验证层(质量保证)
工具 | 说明 |
| 非流形/孤立顶点/零面积/质量分(目标 ≥90) |
| 距离/间隙/对齐 |
| 尺寸/接触断言 |
动画层(AI 影视工作流)
工具 | 说明 |
| 时间轴控制 |
| 关键帧动画(角度/插值:bezier/linear/bounce) |
| 相机运镜(环绕 360°/推拉,自动跟踪目标) |
| 转盘/漂浮/出现(产品展示三件套) |
| 约束(track_to/follow_path/copy_*) |
| 刚体物理(active/passive,AI 设参→引擎模拟) |
| 多帧截图(动画视觉验证核心:AI 对比帧看运动) |
| 渲染帧序列(eevee 预览/cycles 成片) |
| 沿曲线路径运动 |
视觉层
工具 | 说明 |
| OpenGL 快速截图(毫秒级,用于自审) |
| 导出 FBX/GLB(正确轴/单位/嵌入纹理) |
UE 层 + 传输层
工具 | 说明 |
| Actor 管理 |
| Blueprint 结构化操作 |
| 材质 |
| Blender→UE 完整管线 |
| 场景生成 |
专家提示词(6 个)
blender_best_practices · topology_best_practices · scale_reference_guide ·
material_workflow_guide · lighting_principles · auto_critique_workflow ·
animation_workflow
使用示例
"检查 Blender 和 UE 的连接状态" → bridge_status
"在 Blender 建一栋 6x5x3m 的中世纪房屋,
门宽1m 高2.1m 在中间,3个窗,山墙屋顶" → build_medieval_house
"检查刚才的房屋网格质量,然后截图看看" → check_scene_quality + capture_blender_screenshot
"墙宽0.2m,验证厚度对不对" → assert_dimensions
"让相机环绕房屋转一圈,120帧,然后多帧截图验证" → camera_orbit + capture_animation_frames
"把房屋导出FBX并导入UE的 /Game/VillageDemo/" → transfer_model / export_blender_modelAI 动画演示
python scripts/demo_animation.py # 动画设置 + 多帧验证
python scripts/demo_animation.py --render # 额外渲染成片 (eevee)流程: 建模 → 相机运镜 (环绕/推拉) → 物体动画 (转盘/漂浮/出现) → 刚体物理 (掉落模拟) → 多帧截图验证 → 渲染成片
配置
config.json:
unreal.content_dir:UE 项目 Content 目录(可用环境变量UE_CONTENT_DIR覆盖,多项目)shared_assets.base_dir:留空 = 项目内shared_assets/(可用BRIDGE_SHARED_DIR覆盖)Blender 端口 9876(addon 固定),UE 端口 55557
项目结构
blender-ue-bridge/
├── blender_addon/ # Blender 插件 (零依赖)
│ ├── __init__.py # 注册 + 启停
│ ├── server.py # TCP 服务器 + 线程安全队列
│ ├── protocol.py # 长度前缀协议
│ ├── commands.py # 原子命令 (创建/变换/网格编辑/材质/测量/质量)
│ ├── macros.py # 宏命令 (墙/屋顶/门窗/楼梯/家具/房屋工作流)
│ └── ui.py # Sidebar 面板
├── mcp_server/
│ ├── server.py # MCP 主服务器 (62 工具)
│ ├── blender_tools.py # 分层工具注册
│ ├── blender_client.py # 新协议客户端 (排队/轮询/重试)
│ ├── ue_client.py # UE 客户端
│ ├── asset_pipeline.py # 资产管线
│ ├── vision_feedback.py # 视觉反馈
│ └── prompts.py # 专家提示词
├── scripts/
│ ├── install_addon.py # Addon 安装器
│ ├── setup_mcp.py # MCP 配置
│ ├── test_bridge.py # 端到端测试
│ ├── test_protocol.py # 协议层测试 (无需 Blender)
│ └── demo_precision.py # 精确建模演示
├── shared_assets/ # 资产交换目录
├── config.json
└── pyproject.toml许可证
MIT License
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceUnreal-Blender MCP is a unified server for controlling both Blender and Unreal Engine via AI agents using the MCP (Machine Control Protocol) approach.14MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables AI models to directly control Blender for 3D modeling, scene manipulation, and material management through natural language. It supports advanced workflows including Python code execution, viewport visualization, and integration with external asset libraries like Poly Haven and Hyper3D.221MIT
- Alicense-qualityCmaintenanceAn MCP server that enables AI agents to control Blender through natural language for 3D scene creation, animation, and rendering. It provides over 550 actions and direct Python execution via a bridge to a live local Blender session.3MIT
- AlicenseBqualityBmaintenanceComprehensive MCP server for Blender with 308 tools across 25 modules, enabling AI-powered 3D creation and full VRChat avatar pipeline.41002MIT
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
MCP server for Google Veo AI video generation
MCP server for Wan AI video generation
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/malinaa1/blender-ue-bridge'
If you have feedback or need assistance with the MCP directory API, please join our Discord server