还在为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++插件复制到项目目录——这对老项目来说是一个巨大的优势,避免了编译、冲突等麻烦。

你需要做的是:

  1. 确保UE项目中启用了 Python Editor Script Plugin

  2. 在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环境吧。

Logo

欢迎加入 MCP 技术社区!与志同道合者携手前行,一同解锁 MCP 技术的无限可能!

更多推荐