# chongdashu/unreal-mcp

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

Repository: https://github.com/chongdashu/unreal-mcp
Canonical: https://ross.abutalabs.com/products/unreal-mcp
Language: C++
License Family: other
Topics: mcp-server, unreal-engine-5, modelcontextprotocol
Last push: 2025-04-22T02:02:27+00:00

## Health v2 (maintenance only)
Score: 27/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 17, release rhythm 35, longevity 37
- inputs: {"age_days": 523, "days_push": 499, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2065, forks 340 (observed 2026-08-28T04:06:10.097271+00:00)

## What it is
An Unreal Engine 5 plugin plus a Python MCP server that lets AI assistant clients like Cursor, Windsurf, and Claude Desktop control Unreal Engine through natural language via the Model Context Protocol. It exposes tools for actor management, Blueprint creation and node graph editing, and editor viewport control over a TCP connection.

## Use cases
- create and manipulate actors in Unreal Engine using natural language
- generate Blueprint classes and components from an AI assistant
- edit Blueprint node graphs through Cursor or Claude Desktop
- automate repetitive Unreal Editor workflows with an LLM
- control the editor viewport camera via natural language commands

## When to choose
- you use Unreal Engine 5.5+ and want AI-assisted editor automation
- you want an MCP server for Unreal with Cursor, Windsurf, or Claude Desktop
- you are prototyping game scenes and want natural language actor/Blueprint tooling

## When to avoid
- you need a stable, production-ready tool - the project is explicitly experimental with breaking changes
- you use an Unreal Engine version older than 5.5
- you need a license-guaranteed usage - the repository has no license file

## Facets
- artifact type: plugin
- maturity: experimental
- function: mcp, agent-framework, developer-tools, workflow-automation
- domain: developer-tools
- platform: windows, python, cpp
- tags: unreal-engine-5, mcp-server, cursor, claude-desktop, blueprint-automation, editor-plugin, game-development, ai-agents, automation, macos, linux

## Member repositories
- chongdashu/unreal-mcp (main) score 27

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:10.097271+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:56:55.282687+00:00, confidence not recorded.
  - readme: https://github.com/chongdashu/unreal-mcp (fetched 2026-08-28T04:06:10.097271+00:00, sha a60f3ebeeb43)
- Data as of 2026-08-30T08:39:29.467469+00:00.