专注于 UE4.27.2 的 Unreal Engine MCP 服务器，使用 Unreal Python 远程执行

unreal-mcp-ue4 起源于runreal/unreal-mcp的核心理念和早期工作流程，但后来为Unreal Engine 4.27.2进行了大量重构，并扩展了许多新工具、UE4专用兼容层、文档和烟雾覆盖。目前，最初的灵感依然存在，但公开界面和日常行为已大不相同，且以UE4为先。

该移植及后续工具、文档和烟雾测试工作均由OpenAI Codex协助开发。

该项目仍在积极开发中，因此仍有可能出现漏洞、粗糙之处以及UE4.27特有的限制。

已发布的包：unreal-mcp-ue4 注册名称：io.github.conaman/unreal-mcp-ue4

概述

• 无需从该仓库中自定义 Unreal C++ 插件。
• 服务器通过虚幻内置的 Python 远程执行路径与编辑器通信。
• 工具表面被组织为粒度工具和更高级别的工具命名空间。
• 仅限UE5的编辑器脚本功能未重新引入;UE4。

unreal-mcp-ue4

UE4.27.2-focused MCP server for Unreal Engine using Unreal Python Remote Execution

unreal-mcp-ue4 started from the core idea and early workflow shape of runreal/unreal-mcp, but it has since been heavily refactored for Unreal Engine 4.27.2 and expanded with many new tools, UE4-specific compatibility layers, documentation, and smoke coverage. At this point, the original inspiration remains, but the public surface and day-to-day behavior are substantially different and UE4-first.

This port and the follow-up tool, documentation, and smoke-test work were developed with assistance from OpenAI Codex.

This project is still under active development, so bugs, rough edges, and UE4.27-specific limitations may still surface.

Published package: unreal-mcp-ue4
Registry name: io.github.conaman/unreal-mcp-ue4

Overview

• No custom Unreal C++ plugin from this repository is required.
• The server talks to the editor through Unreal’s built-in Python Remote Execution path.
• The tool surface is organized into granular tools and higher-level tool namespaces.
• UE5-only editor scripting features are not reintroduced; UE4.27-safe operations work normally, while unreliable graph or binding flows are either excluded from the MCP surface or return a clear message instead of silently failing.

Origin

• Original inspiration and starting point: runreal/unreal-mcp
• The current codebase has gone through extensive UE4.27-focused refactoring, architecture changes, and tool expansion.
• In practice, the shared idea is still visible, but the implementation, scope, and supported workflows now reflect a separate UE4-first project.
• Unreal Python API reference: Unreal Engine Python API 4.27

Safety

• This is not an official Epic Games project.
• Any connected MCP client can inspect and modify your open Unreal Editor session.
• Use a disposable test project first, especially when trying asset or world-generation tools.

Requirements

• Unreal Engine 4.27.2
• Node.js 18+
• npm
• An MCP client such as Codex, Claude Code, Claude Desktop, Cursor, or GitHub Copilot in a supported IDE

MCP Client Setup

This is the most important setup step: your MCP client must know how to launch unreal-mcp-ue4.

1. Install the server

Recommended global install: