ChiR24/Unreal_mcp

解决的问题

此项目在 AI 助手（如 Claude、Cursor 或 VS Code）与 Unreal Engine 编辑器之间提供了一座桥梁。它让 AI 能直接与编辑器交互，以构建关卡、创建蓝图、设计 UI、设置材质，以及管理游戏系统，而无需用户手动在引擎中执行每个操作。

工作原理

该系统包含一个名为 MCP Automation Bridge 的原生 C++ 编辑器插件，在 Unreal Engine 内部运行。AI 客户端使用 Model Context Protocol (MCP) 通过两种可能的路径连接到此插件：

• 路径 A（原生 HTTP）： 客户端直接连接到该插件的 HTTP 服务器（默认端口 3000），并使用能力令牌进行身份验证。
• 路径 B（stdio）： 客户端通过 Node.js 服务器（unreal-engine-mcp-server）连接，该服务器通过 stdio 和 WebSockets（默认端口 8090）作为代理。

该插件不是公开数百个单独工具，而是公开一个单一的 unreal 工具。AI 助手使用网关流程：它搜索能力（例如“生成角色”）、描述特定操作以获取所需参数，然后执行该操作。

适用对象

使用 Unreal Engine 5.0 至 5.8 的游戏开发者和技术美术，希望自动化编辑器任务，或使用 AI 加速关卡设计、蓝图创建和世界构建流程。

亮点

• 广泛的能力： 近 400 个编辑器操作，涵盖关卡、角色、蓝图、UI、UMG、材质、Niagara 效果和 AI 行为树。
• 灵活的连接方式： 支持直接 HTTP 和 stdio 传输，以适应不同的 AI 客户端。
• 原生集成： 以 C++ 插件构建，确保在游戏线程上能深入访问编辑器 API。
• 安全机制： 破坏性操作需要特定的同意授权，以防止意外删除。
• AI 友好的发现： 使用基于搜索的系统，让 AI 无需记住数百个工具名称。