db-lyon/ue-mcp

解决的问题

UE-MCP 允许 AI 助手直接与 Unreal Engine 编辑器交互。它通过提供一个可编程接口，消除了将自然语言请求手动转换为复杂编辑器操作的繁琐工作，使 AI 代理能够构建关卡、创建材质、编写蓝图并管理项目资产。

工作原理

该项目实现了 Model Context Protocol (MCP)，在 AI 客户端（如 Claude 或 Cursor）与 Unreal 编辑器之间建立桥梁。它由一个 TypeScript/Node.js 服务器组成，通过 WebSocket/JSON-RPC 与安装在 Unreal 编辑器内部的 C++ 桥接插件通信。该架构使代理能够在 24 个类别中执行超过 1,000 个操作，包括对 C++ 头文件和 INI 配置文件的直接文件系统访问，即使编辑器未打开也能实现项目探索。

适用人群

使用 Unreal Engine 5.4–5.8 的游戏开发者和技术美术，希望自动化编辑器任务、通过 AI 生成程序化内容，或让 AI 代理处理项目中重复性技术设置的人群。

主要亮点

• 深度编辑器访问：可控制从 Niagara VFX 和 PCG 图形到 Gameplay Ability System (GAS) 和 StateTree 的一切内容。
• YAML 流程：支持以 YAML 定义的多步骤工作流，可热重载并具备回滚功能。
• 原生工具集集成：封装 Epic 官方 AI 工具集注册表（UE 5.8+），将数百个官方工具作为代理操作呈现。
• 可扩展架构：可通过 npm 插件系统添加新操作。
• 安全防护机制：包含写入保护和源代码控制集成，防止 AI 代理意外覆盖关键项目数据。