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

CLAUDE.md — unreal-source-mcp

Project Overview

unreal-source-mcp — Deep Unreal Engine source intelligence for AI agents.

An MCP (Model Context Protocol) server that indexes all UE C++ and HLSL source code into a SQLite database, providing structural queries (class hierarchy, call graphs, cross-references) and full-text search across the entire engine codebase.

Complements (does not replace):

• 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: Implementation-level understanding — actual source code, cross-references, call graphs, and patterns.

Tech Stack

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

Project Structure

unreal-source-mcp/
├── pyproject.toml              # Package config, dependencies, entry point
├── CLAUDE.md                   # This file
├── README.md                   # User-facing docs
├── LICENSE                     # MIT
├── src/
│   └── unreal_source_mcp/
│       ├── __init__.py         # Version
│       ├── __main__.py         # Entry point (uvx runs this)
│       ├── server.py           # MCP server + tool registration
│       ├── indexer/
│       │   ├── __init__.py
│       │   ├── pipeline.py     # Orchestrates full indexing run
│       │   ├── cpp_parser.py   # tree-sitter C++ symbol/reference extraction
│       │   ├── shader_parser.py# Regex-based HLSL extraction
│       │   ├── ue_macros.py    # UCLASS/UFUNCTION/UPROPERTY macro handling
│       │   └── reference_builder.py  # Cross-reference extraction
│       ├── db/
│       │   ├── __init__.py
│       │   ├── schema.py       # SQLite table definitions + migrations
│       │   └── queries.py      # All SQL queries (no inline SQL elsewhere)
│       └── tools/
│           ├── __init__.py
│           ├── read_source.py
│           ├── find_references.py
│           ├── search_source.py
│           ├── class_hierarchy.py
│           ├── module_info.py
│           └── symbol_context.py
└── tests/
    ├── test_cpp_parser.py
    ├── test_shader_parser.py
    ├── test_queries.py
    └── fixtures/
        └── sample_ue_source/   # Small UE-like .h/.cpp files for testing