ue-maintainer-mcp

Read-first MCP server for Unreal Engine open-source maintainers.

ue-maintainer-mcp helps AI coding agents review Unreal pull requests, understand project impact, inspect asset dependency risks, triage logs, and prepare release preflight reports without granting unrestricted Unreal Editor control by default.

Why This Project

Most Unreal MCP projects focus on direct editor control: spawning actors, editing Blueprints, generating levels, or authoring assets. This project focuses on maintainer automation instead:

• PR impact analysis.
• Unreal project/module/plugin snapshots.
• Safe headless commandlet planning.
• Unreal log triage.
• Asset dependency risk scans.
• Release preflight reports.

The first implementation is intentionally read-first and headless-first. A running Unreal Editor is not required for the core analysis tools.

Install

uv sync --extra dev

Run The MCP Server

uv run ue-maintainer-mcp serve

The server uses stdio transport by default for local MCP clients.

Try The CLI

uv run ue-maintainer-mcp project-snapshot tests/fixtures/sample_project
uv run ue-maintainer-mcp project-index tests/fixtures/sample_project
uv run ue-maintainer-mcp diff-impact --diff-file tests/fixtures/sample.diff --project-path tests/fixtures/sample_project
uv run ue-maintainer-mcp changed-areas --project-path tests/fixtures/sample_project
uv run ue-maintainer-mcp triage-logs tests/fixtures/logs
uv run ue-maintainer-mcp release-preflight tests/fixtures/sample_project

MCP Tools

• project_index: build a compact reusable index of project modules, plugins, content areas, and changed areas.
• project_snapshot: summarize .uproject, modules, plugins, config, and directory structure.
• changed_area_summary: compact changed files into reviewable source/content/plugin areas.
• diff_impact: classify Unreal-specific PR changes and suggest checks.
• asset_dependency_audit: find asset dependency signals from read-only scans or an exported Asset Registry JSON graph.
• api_lookup: query a local Unreal API index, with a small seed index included.
• run_unreal_commandlet: build safe allowlisted commandlet invocations.
• triage_unreal_logs: convert Unreal logs into deduped actionable findings with noise filters.
• release_preflight: aggregate maintainer checks into JSON and Markdown.
• review_report: generate compact role-aware PR review reports.

Advanced Direction

The project is moving beyond ad hoc CLI wrappers toward a durable Unreal maintenance intelligence layer:

• compact indexes instead of huge JSON dumps,
• Asset Registry-backed dependency graph imports,
• changed-area summaries instead of repeated per-file warnings,
• log filtering and deduplication,
• role-aware reports for maintainers, QA, tech artists, producers, and build engineers.

Safety Defaults

• Local stdio transport by default.
• Read-only project analysis by default.
• No arbitrary Python execution.
• No raw shell command input.
• Unreal commandlets are allowlisted and dry-run by default.
• Actual command execution requires UE_MAINTAINER_ALLOW_COMMANDS=1 plus dry_run=false.
• Secret-like config keys are redacted from snapshots.

Development

uv run pytest
uv run ruff check .

Roadmap

See SPEC.md for the locked MVP scope and milestone plan.

For broader product direction across indie-to-AAA Unreal projects, see Universal Unreal Maintainer Opportunities.