UE老项目如何用MCP拥抱AI开发
还在为UE5.8的MCP官方支持眼馋?你的UE5.5项目其实不用干等升级
UE5.8内置MCP插件,让很多开发者兴奋不已。但对于那些已有大量资产、插件依赖、定制流程的老项目来说,升级引擎版本往往意味着数周乃至数月的迁移成本、兼容性测试和风险。升级,谈何容易。
UE5.5没有原生MCP支持,但这并不意味着老项目就要被AI开发浪潮抛弃。本文将介绍如何在UE5.5项目中通过 UnrealEngine-ai-mcp 插件接入MCP生态,让AI助手(Claude、Codex、Cursor等)直接操作你的虚幻引擎——不需要等UE5.8,现在就上手。
为什么是UnrealEngine-ai-mcp?
目前社区存在多个UE MCP实现方案,各有侧重。gingerol/UnrealEngine-ai-mcp 是一个值得UE5.5老项目优先考虑的选项:
| 特点 | 说明 |
|---|---|
| 引擎版本门槛低 | 明确支持UE5.5+,与老项目完美兼容 |
| 架构清晰 | 轻量级Python桥接,没有复杂的依赖链,便于理解和维护 |
| 工具覆盖面广 | 涵盖蓝图创建、Actor操作、节点图编辑、UMG、项目设置等核心开发领域 |
| 有示例可参考 | 提供examples/目录,开箱即用的脚本降低学习成本 |
不同于某些侧重C++深度集成的方案,UnrealEngine-ai-mcp采用Python MCP Server + UE Python API的方式运行,对项目本身没有侵入性,非常适合已有工程结构的老项目引入。
实战配置:30分钟让你的UE5.5接入AI
前置条件
-
Unreal Engine 5.5(已安装,Python支持已启用)
-
Python 3.10+
-
uv 包管理器(推荐)或pip
-
MCP客户端:Claude Desktop、Cursor或Windsurf
Step 1:获取插件
bash
git clone https://github.com/gingerol/UnrealEngine-ai-mcp.git cd UnrealEngine-ai-mcp
Step 2:安装Python依赖
使用uv(推荐):
bash
uv pip install -e .
或使用pip:
bash
pip install -e .
Step 3:将插件接入你的UE项目
UnrealEngine-ai-mcp本质上是一个Python MCP服务器,通过UE的Python Remote Execution与编辑器通信,因此无需将C++插件复制到项目目录——这对老项目来说是一个巨大的优势,避免了编译、冲突等麻烦。
你需要做的是:
-
确保UE项目中启用了 Python Editor Script Plugin
-
在UE编辑器中启用 Remote Execution 功能(Edit > Project Settings > Python)
Step 4:启动MCP服务器
在终端运行:
bash
python unreal_mcp_server.py
服务器启动后,会注册所有可用工具,等待MCP客户端连接。
Step 5:配置AI客户端
以Claude Desktop为例,编辑配置文件 claude_desktop_config.json:
Windows路径:%APPDATA%\Claude\claude_desktop_config.json
macOS路径:~/Library/Application Support/Claude/claude_desktop_config.json
json
{
"mcpServers": {
"unreal-mcp": {
"command": "python",
"args": ["/你的路径/UnrealEngine-ai-mcp/unreal_mcp_server.py"]
}
}
}
对于Cursor IDE,在项目根目录创建 .cursor/mcp.json,配置相同内容即可。
配置完成后重启Claude Desktop,你应该能看到Unreal Engine相关的工具列表(点击锤子图标查看)。
能做什么?用自然语言驱动UE开发
配置成功后,你可以这样使用AI:
生成Actor:
“在当前场景中生成一个立方体,位置在(0, 0, 100),缩放为2”
创建蓝图:
“创建一个名为BP_RotatingCube的蓝图,添加一个Cube静态网格组件,在Tick事件中让它绕Y轴旋转”
编辑器操作:
“找到场景中所有名为‘Light_*’的Actor,把它们的强度调高50%”
UMG开发:
“创建一个Widget蓝图,添加一个TextBlock显示‘Hello AI’,再添加一个Button”
这些能力都来自UnrealEngine-ai-mcp提供的工具分类:Editor Tools、Blueprint Tools、Node Tools、Project Tools、UMG Tools。
与其他方案的简单对比
| 项目 | 引擎版本 | 特点 | 适用场景 |
|---|---|---|---|
| UnrealEngine-ai-mcp (gingerol) | 5.5+ | 轻量Python桥接,架构清晰 | 老项目快速接入,学习成本低 |
| Unreal-MCP (chongdashu) | 5.5+ | 功能全面,中文支持好,Web管理界面 | 追求多功能、一站式方案 |
| Ultimate Unreal Engine MCP | 5.7 | 133工具/26领域,含C++分析 | UE5.7新项目 |
| Unreal MCP (IvanMurzak) | 5.4+ | 62工具/8家族,C++编辑编译 | 需要深度C++操作的团队 |
对于不想升级引擎、不想引入C++插件的老项目来说,gingerol的UnrealEngine-ai-mcp是最低门槛的选择。
写在最后:给老项目一条AI之路
UE5.8的官方MCP固然值得期待,但不该成为你尝试AI驱动开发的阻碍。你的UE5.5老项目现在就可以通过UnrealEngine-ai-mcp获得:
-
自然语言驱动的蓝图/Actor/UMG开发能力
-
无需升级引擎、无需编译C++插件的零侵入接入
-
与Claude Desktop、Cursor等主流AI工具的协同工作流
把重复性工作交给AI,把创意留给自己。现在就动手配置你的UE5.5 MCP环境吧。
更多推荐

所有评论(0)