第一部分简介设计并实现「大模型规划 MCP/HTTP 通信 UE C 执行」三段式架构将 UE 5.3 编辑器中的蓝图、资产、Enhanced Input、GameMode、UMG 等能力封装为28 个可调用 Tool支持 Cursor MCP、Ollama Function Calling、Web GUI 多入口统一编排并导出蓝图 Schema 供 Cursor 编写 C 玩法逻辑形成自然语言驱动工程落地的闭环。工作内容划分 AI 规划层、MCP/通信层、UE 执行层职责设计 Tool Schema 与能力边界降低大模型幻觉对工程内容的污染。基于 UE Editor C 开发 AIUEBridge 插件封装资产扫描、蓝图创建/修改、GameMode Classes / 项目默认 GameMode、Enhanced Input、UMG、GameplayTag/DataTable 等 HTTP Tool。用 Python 实现 MCP Server 与 FastAPI Web Agent对接 Cursor / Ollama完成自然语言 → 多轮 Tool 编排 → UE 落盘。实现 GameMode / Pawn / PlayerController 一键创建与 Classes 自动配置沉淀 Recipe/CLI 与文档。实现export_for_cursor将蓝图上下文导出为 Markdown/JSON支撑「AI 搭框架、C 写交互」的人机协同流程。完善健康检查、端口配置、Tool 日志与失败可观测梳理编辑器自动化边界。落地28个编辑器自动化 Tool覆盖蓝图框架、Enhanced Input、GameMode 配置等关键路径。打通 Cursor / Ollama / Web 三端共用同一套 UE 执行层验证 MCP Function Calling 在游戏工具链中的可行性。形成「自然语言搭框架 → 自动化配置 → Cursor 辅助写 C」可复用工作流缩短从需求到可运行框架的搭建成本。技术栈关键词Unreal Engine 5·UE Editor Plugin·C·Blueprint·Enhanced Input·MCP·LLM Agent·Function Calling·Ollama·Cursor·FastAPI·Python第二部分AIUEBridge 解决方案 · 应用场景 · 使用方式结合README.md与mcp_server/README.md整理的落地指南Unreal Engine AI 执行层插件 — 把 UE 编辑器能力封装成 AI 可调用的 HTTP 工具集一、解决方案问题定义与解法解决什么问题传统 UE 开发中蓝图/资产/接口/Input 等操作依赖编辑器手工完成难以被 AI 或代码自动化驱动。AIUEBridge 提供了一条「AI 规划 → UE 执行」的闭环AI 负责规划Plan → Cursor / Ollama / 外部 AI UE 负责执行Execute → UE Editor API 在编辑器内真正执行 MCP 负责通信Protocol→ HTTP / MCP / 自然语言转发核心设计理念原则说明不是 AI不含 LLM / RAG / 规划逻辑只做 UE 能力暴露不是 MCP 本身是一次「执行层」MCP 只是其中一种通信协议执行是真的所有 Tool 均通过 UE Editor API 在编辑器内真实执行单一入口插件:18765是所有 UE 操作的唯一 HTTP 入口分层职责层级组件职责AI 层Cursor / Ollama / 外部 AI规划、推理、C 代码编写通信层mcp_server / Web GUIMCP 协议、自然语言、HTTP 转发执行层AIUEBridge 插件梳理/创建蓝图资产、导出 Cursor 上下文输出层cursor_blueprint_context.md蓝图 → Cursor 可理解的 C 提示二、应用场景场景 1AI 驱动蓝图创建最核心程序化生成 Actor、道具、NPC 蓝图原型。AI 规划 → create_blueprint → add_component → add_variable → compile_blueprint适合批量搭建关卡物体、快速原型验证、占位资产生成。场景 2项目资产审计让 AI 先了解 Content 目录结构再做决策。AI 分析 → list_assets / search_assets → get_asset_info适合资产盘点、命名规范检查、重复资产排查。场景 3蓝图结构分析 / Refactor 规划AI 读取 → read_blueprint → 分析组件/变量/Graph → 给出修改建议适合理解他人蓝图、重构前评估、依赖关系梳理。场景 4快速搭建基础系统create_input_action create_input_mapping → 输入系统 create_widget add_widget_node → UI 框架 create_datatable create_dataasset → 配置数据 create_gameplay_tag → 标签体系适合新项目脚手架、Demo 快速启动、竖切vertical slice。场景 5蓝图梳理 → Cursor 编写 C将现有 Blueprint/Interface/Input 映射转为 C 原生类。scan_blueprint_assets → export_for_cursor → Cursor 引用 md → 生成 C → UE 编译适合蓝图转 C 重构、新建 BPI 后生成对应UINTERFACE、团队工程化迁移。场景 6一键 GameMode 配置create_blueprint(BP_GameMode2) → configure_game_mode → set_project_default_game_mode适合快速配置项目默认 GameMode、Pawn、PlayerController 等。场景 7日常开发 AI 副驾驶在 Web GUI 用自然语言让 AI 在编辑器里操作类似「UE 版 Copilot」。适合不想记 Tool 命令的美术/策划/原型设计师。三、使用方式四种入口方式是否需要 Cursor命令 / 地址适合用户Web GUI⭐否python mcp_server/web_app.py→ http://127.0.0.1:8080图形化聊天操作非开发者自然语言 CLI否python mcp_server/nl_chat.py终端用户 / 脚本化MCP Server可选python mcp_server/server.pyCursor 及 MCP 客户端HTTP 直连否curl POST :18765/api/tool/execute开发者 / CI / 第三方工具四、完整启动流程一次性准备首次使用# 1. 启动 UE 编辑器并加载插件# 打开 AIUEBridgeTest.uproject确认 Output Log 有:# LogAIUEBridge: AIUEBridge HTTP server started on port 18765# 2. 启动 Ollama 并拉取模型ollama serve ollama pull qwen2.5:7b# 3. 配置 Python 环境cdmcp_server copy .env.example .env# 复制配置模板python-mvenv .venv# 创建虚拟环境.venv\Scripts\activate# Windows 激活pipinstall-rrequirements.txt# 4. 启动 Web GUIpython web_app.py# 浏览器打开 http://127.0.0.1:8080日常使用三件事都开着服务状态验证UE 编辑器含插件:18765curl http://127.0.0.1:18765/api/healthOllama:11434页面状态灯为绿色Web GUI:8080浏览器可打开五、Web GUI 使用示例基础指令在 /Game/Characters 下创建名为 BP_Enemy 的 Actor 蓝图 给 /Game/Characters/BP_Enemy 添加 StaticMeshComponent名字叫 Mesh 列出 /Game 目录下所有蓝图 搜索名称包含 Player 的资产快捷指令左侧一键按钮等效指令列出蓝图列出 /Game 目录下所有蓝图资产创建蓝图在 /Game/Test 下创建一个名为 BP_Demo 的 Actor 蓝图搜索 Player搜索名称包含 Player 的资产界面要点左侧状态灯UE 插件绿 / Ollama 绿 可正常操作AI 回复下方「⚙ 执行了 N 个 UE 工具」点击展开 Tool 调用日志清空对话清历史不影响 UE 已建资产配置文件修改后需重启web_app.py六、curl / HTTP 直连示例# 健康检查curlhttp://127.0.0.1:18765/api/health# {status:ok,service:AIUEBridge,port:18765}# 创建蓝图curl-XPOST http://127.0.0.1:18765/api/tool/execute\-HContent-Type: application/json\-d{\tool\:\create_blueprint\,\params\:{\name\:\BP_Enemy\,\path\:\/Game/Characters\,\parent_class\:\Actor\}}# 添加组件curl-XPOST http://127.0.0.1:18765/api/tool/execute\-HContent-Type: application/json\-d{\tool\:\add_component\,\params\:{\asset_path\:\/Game/Characters/BP_Enemy\,\component_class\:\StaticMeshComponent\,\component_name\:\Mesh\}}# 导出 Cursor C 上下文curl-XPOST http://127.0.0.1:18765/api/tool/execute\-HContent-Type: application/json\-d{\tool\:\export_for_cursor\,\params\:{\path\:\/Game\,\write_to_file\:true}}七、Cursor / MCP 接入方式配置文件.cursor/mcp.json{mcpServers:{aiue-bridge:{command:C:/path/to/mcp_server/.venv/Scripts/python.exe,args:[C:/path/to/AIUEBridge/mcp_server/server.py],env:{UE_BRIDGE_URL:http://127.0.0.1:18765}}}}保存后重启 Cursor生效。八、配置速查.env变量默认值说明UE_BRIDGE_URLhttp://127.0.0.1:18765须与 UEMCPPort一致OLLAMA_URLhttp://127.0.0.1:11434Ollama 地址OLLAMA_MODELqwen2.5:7b默认 LLM需支持 function callingWEB_PORT8080Web GUI 端口MAX_TOOL_ROUNDS8单轮最多连续 Tool 调用ENABLE_SHELLtrueWeb 左栏 CMD 终端开关修改端口需保证 UEMCPPort与UE_BRIDGE_URL一致.env改动后重启 Web 服务。九、能力边界注意事项可以做创建/读取/修改蓝图与基础资产、添加组件/变量/函数、Widget Blueprint、Enhanced Input、DataTable、DataAsset、Gameplay Tag、导出 Cursor C 上下文。不能做限制说明编辑器专用无法打入 Shipping / 打包版本无 Graph 连线不能添加或连接蓝图节点 Pin无 Material / Level未实现材质、关卡操作无自动 C 写入只导出 schema不自动写 Source 或触发 UBT 编译无 AI 推理不含 LLM / RAG / 规划由外部 AI 层负责无 HTTPS仅本地 HTTP不对外网暴露十、故障排查速查现象处理Web 打不开python web_app.py未运行UE 红灯开 UE确认插件加载 Log 有 HTTP startedOllama 红灯ollama serveollama pull对应模型发送后无响应增大OLLAMA_TIMEOUT/UE_BRIDGE_TIMEOUTAI 不操作 UE换支持 function calling 的模型qwen2.5:7b端口不一致统一 UEMCPPort与.envUE_BRIDGE_URL改.env无效重启web_app.py十一、一句话总结AIUEBridge 把 UE 编辑器 API 封装成 AI 可调用工具的执行引擎是 UE 被 AI 控制的唯一入口。
)
