DEPRECATED-unreal-editor-mcp: Instructions file for Claude Code

CLAUDE.md — unreal-editor-mcp

Project Overview

unreal-editor-mcp — Build diagnostics and editor log tools for Unreal Engine AI development.

An MCP (Model Context Protocol) server that provides structured access to UE editor build output and log files. Trigger Live Coding builds, inspect parsed errors, search/filter editor logs, and get crash context — all without leaving the AI workflow.

Complements (does not replace):

• unreal-source-mcp — Engine-level source intelligence
• unreal-project-mcp — Project-level source intelligence
• unreal-config-mcp — Config/INI intelligence (inheritance chains, settings search, diff from defaults, CVars)
• unreal-api-mcp — API surface (signatures, includes, deprecation)

We provide: Build control and log visibility — the "feedback loop" for C++ iteration.

Tech Stack

• Language: Python 3.11+
• MCP SDK: mcp Python package (FastMCP)
• Distribution: PyPI via uvx unreal-editor-mcp
• Package manager: uv (for dev and build)
• No database — all state in memory (rolling buffers, build history)

Project Structure

unreal-editor-mcp/
├── pyproject.toml
├── CLAUDE.md
├── src/
│   └── unreal_editor_mcp/
│       ├── __init__.py          # Version
│       ├── __main__.py          # CLI entry point
│       ├── config.py            # UE_PROJECT_PATH, port config, path helpers
│       ├── server.py            # FastMCP + 11 tool definitions
│       ├── editor_bridge.py     # UE remote execution protocol client
│       ├── build/
│       │   ├── __init__.py
│       │   ├── manager.py       # Build state, history, trigger logic
│       │   └── parser.py        # MSVC/UBT error format parsing
│       └── logs/
│           ├── __init__.py
│           ├── tailer.py        # File tailing + rolling buffer
│           └── parser.py        # UE log format parsing
└── tests/
    ├── test_log_parser.py
    ├── test_log_tailer.py
    ├── test_build_parser.py
    ├── test_build_manager.py
    └── test_server.py