# Unreal MCP — Control Unreal Engine via MCP

> Unreal_mcp provides an MCP server + C++ Automation Bridge for Unreal Engine; verified 617★ and supports direct HTTP MCP at :3000.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
npx unreal-engine-mcp-server
# In Unreal: enable Native MCP, set port=3000, restart editor.
claude mcp add unreal-engine --transport http http://localhost:3000/mcp
```

## Intro

Unreal_mcp provides an MCP server + C++ Automation Bridge for Unreal Engine; verified 617★ and supports direct HTTP MCP at :3000.

**Best for:** Unreal teams prototyping with AI: automate editor tasks, assets, levels, screenshots, and sequencer workflows

**Works with:** Unreal Engine (README mentions UE 5.0–5.8) + MCP clients (Claude Code/Cursor/etc.)

**Setup time:** 20-45 minutes

### Key facts (verified)

- GitHub: 618 stars · 110 forks · pushed 2026-05-13.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `npx unreal-engine-mcp-server`.

## Main

- Decide transport first: direct HTTP MCP inside the plugin is simplest; use the TypeScript bridge only if you need stdio-style setups.

- Treat plugin compilation as one-time bootstrap: build for your UE version, then distribute binaries to teammates.

- Start with low-risk operations (screenshots, asset listing) before enabling destructive tools in agent sessions.

### Source-backed notes

- README describes a native C++ Automation Bridge plugin and dual transport (native HTTP/SSE or WebSocket bridge).
- README shows native HTTP MCP with default port 3000 and sample `claude mcp add ... --transport http` wiring.
- README notes Blueprint-only projects can’t compile native plugins without adding a C++ class first.

### FAQ

- **Do I need Node.js for the native path?**: No — README says the plugin includes a built-in HTTP MCP server.
- **Will one build work across UE versions?**: No — README notes binaries are tied to a specific UE version.
- **How do I verify it’s connected?**: Check Unreal logs for MCP transport messages and your client’s server status.

## Source & Thanks

> Source: https://github.com/ChiR24/Unreal_mcp
> License: MIT
> GitHub stars: 618 · forks: 110

---

<!-- ZH -->

## Quick Use

```bash
npx unreal-engine-mcp-server
# In Unreal: enable Native MCP, set port=3000, restart editor.
claude mcp add unreal-engine --transport http http://localhost:3000/mcp
```

## Intro

Unreal_mcp 提供 MCP server 与 C++ Automation Bridge 插件以控制 Unreal Engine；已验证 617★，支持插件内置 :3000 的 HTTP MCP，并覆盖 UE 5.0–5.8 的编辑器自动化。

**Best for:** 用 AI 做 UE 原型的团队：自动化编辑器操作、资源/关卡管理、截图与 Sequencer 工作流

**Works with:** Unreal Engine（README 提到 UE 5.0–5.8）+ MCP 客户端（Claude Code/Cursor 等）

**Setup time:** 20-45 minutes

### Key facts (verified)

- GitHub：618 stars · 110 forks；最近更新 2026-05-13。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`npx unreal-engine-mcp-server`。

## Main

- 先决定传输方式：插件内置的 HTTP MCP 最简单；只有在需要 stdio 方案时再用 TypeScript bridge。

- 把插件编译当一次性引导：为指定 UE 版本编译好 Automation Bridge 后分发二进制即可。

- 先从低风险操作开始（截图/列资源），再逐步在 agent session 中开启高风险工具。

### Source-backed notes

- README 描述原生 C++ Automation Bridge 插件，并支持双传输（插件内置 HTTP/SSE 或桥接方案）。
- README 给出 native HTTP MCP（默认端口 3000）与 `claude mcp add ... --transport http` 示例命令。
- README 提到纯蓝图项目无法编译原生插件，需要先添加任意 C++ class。

### FAQ

- **走 native 路径需要 Node.js 吗？**：不需要。README 写明插件内置 HTTP MCP server。
- **一个构建能跨 UE 版本吗？**：不能。README 提到二进制与特定 UE 版本绑定。
- **如何确认已连接？**：查看 Unreal 日志中的 MCP transport 输出，以及客户端侧的 server 状态。

## Source & Thanks

> Source: https://github.com/ChiR24/Unreal_mcp
> License: MIT
> GitHub stars: 618 · forks: 110


---
Source: https://tokrepo.com/en/workflows/unreal-mcp-control-unreal-engine-via-mcp
Author: MCP Hub