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

CLAUDE.md — unreal-project-mcp

Project Overview

unreal-project-mcp — Project-level source and configuration intelligence for Unreal Engine AI development.

An MCP (Model Context Protocol) server that indexes a UE project's C++ source code, config/INI files, Build.cs module dependencies, .uplugin plugin descriptors, gameplay tags, replication markers, asset references, log categories, and pattern classifications into a SQLite database. Provides structural queries (class hierarchy, call graphs, cross-references), config lookups, dependency graphs, and full-text search across the project codebase.

Forked from unreal-source-mcp v0.1.1 (engine-level indexing). This variant focuses on project-level code rather than engine source.

Complements (does not replace):

• unreal-source-mcp — Engine-level source intelligence (full engine C++ and HLSL)
• unreal-config-mcp — Config/INI intelligence (inheritance chains, settings search, diff from defaults, CVars)
• unreal-api-mcp — API surface (signatures, includes, deprecation)
• Agent Integration Kit — Editor control (Blueprints, assets, Python execution)

We provide: Project-level implementation understanding — source code, cross-references, call graphs, config values, module dependencies, plugin metadata, gameplay tags, replication topology, asset references, log categories, and pattern-based classifications within your UE project.

Tech Stack

• Language: Python 3.11+
• Parser: tree-sitter + tree-sitter-cpp (C++ AST)
• Storage: SQLite + FTS5 full-text search
• MCP SDK: mcp Python package
• Distribution: PyPI via uvx unreal-project-mcp
• Package manager: uv (for dev and build)

Project Structure

unreal-project-mcp/
├── pyproject.toml              # Package config, dependencies, entry point
├── CLAUDE.md                   # This file
├── README.md                   # User-facing docs
├── .gitignore
├── src/
│   └── unreal_project_mcp/
│       ├── __init__.py         # Version
│       ├── __main__.py         # Entry point (uvx runs this)
│       ├── config.py           # Env vars, DB path, project name/root detection
│       ├── server.py           # MCP server + all 17 tool handlers
│       ├── indexer/
│       │   ├── __init__.py
│       │   ├── pipeline.py     # Orchestrates full indexing run (4 phases)
│       │   ├── cpp_parser.py   # tree-sitter C++ symbol/reference extraction + UE macro handling
│       │   ├── reference_builder.py  # Cross-reference, asset path, and log category extraction
│       │   ├── config_parser.py      # UE INI config file parser
│       │   ├── build_cs_parser.py    # Build.cs module dependency parser
│       │   ├── plugin_parser.py      # .uplugin plugin descriptor parser
│       │   ├── tag_scanner.py        # Gameplay tag scanner (C++, INI, CSV)
│       │   └── pattern_tagger.py     # Pattern-based classification (subsystems, anim notifies, etc.)
│       └── db/
│           ├── __init__.py
│           ├── schema.py       # SQLite table definitions + FTS5 + triggers (schema v2)
│           └── queries.py      # All SQL queries (no inline SQL elsewhere)
└── tests/
    ├── test_config.py
    ├── test_cpp_parser.py
    ├── test_db.py
    ├── test_pipeline.py
    ├── test_server.py
    ├── test_e2e.py
    ├── test_config_parser.py
    ├── test_build_cs_parser.py
    ├── test_plugin_parser.py
    ├── test_tag_scanner.py
    ├── test_pattern_tagger.py
    └── fixtures/
        ├── sample_project_source/   # UE-like .h/.cpp files for testing
        ├── sample_config/           # UE INI config files for testing
        ├── sample_build_cs/         # Build.cs files for testing
        └── sample_plugins/          # .uplugin files for testing