# ChiR24-unreal_mcp_server

Connect an AI assistant to a running Unreal Editor and let it work with levels, Blueprints, materials, and more. Useful for editor tasks handled through chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 975
- Author: ChiR24
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ChiR24/Unreal_mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server

## What it does

The server connects an assistant to the EngineWire plugin running inside Unreal Editor. Its `unreal` tool can place actors, create Blueprint graphs, arrange UI, edit materials, run Play-In-Editor, and inspect logs. It also covers gameplay systems, effects, and scenes.

Clients can connect over HTTP or through a local Node.js process using stdio and WebSocket. Editor actions run on the game thread, and the server listens on `127.0.0.1`; project capability tokens are required by default. Installing the plugin requires Unreal Engine 5.0–5.8 and a project with C++ code. Blueprint-only projects need prebuilt binaries, while the stdio route requires Node.js 20.19 or later.

## Requirements
- Remote server: `https://server.smithery.ai/@ChiR24/unreal_mcp_server/mcp`
- Works with: Unreal Engine

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http chir24-unreal-mcp-server https://server.smithery.ai/@ChiR24/unreal_mcp_server/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add chir24-unreal-mcp-server --url https://server.smithery.ai/@ChiR24/unreal_mcp_server/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "chir24-unreal-mcp-server": {
            "url": "https://server.smithery.ai/@ChiR24/unreal_mcp_server/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "chir24-unreal-mcp-server": {
            "type": "http",
            "url": "https://server.smithery.ai/@ChiR24/unreal_mcp_server/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http chir24-unreal-mcp-server https://server.smithery.ai/@ChiR24/unreal_mcp_server/mcp
```

## When to use it
- place actors and save a level
- create a Blueprint with variables and components
- build a material graph or Niagara effect
- run Play-In-Editor and capture a screenshot
- inspect project logs from the editor

## Example prompts
- Build a level and place the requested actors in it.
- Create a Blueprint with components and an event graph.
- Run Play-In-Editor, capture a screenshot, and inspect the logs.

## Similar
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1348
- [PartCAD](https://affpapa.org/en/nevibecode/mcp/partcad.md) — MCP server · ★ 509
- [godot-mcp](https://affpapa.org/en/nevibecode/mcp/tomyud1-godot-mcp.md) — MCP server · ★ 443
- [Gearsystem MCP Server](https://affpapa.org/en/nevibecode/mcp/gearsystem-mcp-server.md) — MCP server · ★ 397
- [Funplay Cocos MCP](https://affpapa.org/en/nevibecode/mcp/funplay-cocos-mcp.md) — MCP server · ★ 357
- [Unity MCP](https://affpapa.org/en/nevibecode/mcp/isuzu-shiranui-unity-mcp.md) — MCP server · ★ 335

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md