Unreal Engine Code Analyzer MCP Server

A Model Context Protocol (MCP) server that provides powerful source code analysis capabilities for Unreal Engine codebases. This tool enables AI assistants like Claude and Cline to deeply understand and analyze Unreal Engine source code.

Features

• Class Analysis: Get detailed information about C++ classes including methods, properties, and inheritance
• Hierarchy Mapping: Visualize and understand class inheritance hierarchies
• Code Search: Search through code with context-aware results
• Reference Finding: Locate all references to classes, functions, or variables
• Subsystem Analysis: Analyze major Unreal Engine subsystems like Rendering, Physics, etc.
• Game Genre Knowledge: Built-in knowledge base of game genres, features, and implementation patterns
• Pattern Detection & Learning: Identifies common Unreal Engine patterns and provides learning resources
• Custom Codebase Support: Analyze your own Unreal Engine project codebase

Quick Start

Installation

1. Clone this repository:

git clone https://github.com/ayeletstudioindia/unreal-analyzer-mcp
cd unreal-analyzer-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

For Claude Desktop App

Add the following to your Claude desktop configuration file (%APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "unreal-analyzer": {
      "command": "node",
      "args": ["path/to/unreal-analyzer/build/index.js"],
      "env": {}
    }
  }
}

For Cline

Add the following to your Cline MCP settings file (%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json on Windows):

{
  "mcpServers": {
    "unreal-analyzer": {
      "command": "node",
      "args": ["path/to/unreal-analyzer/build/index.js"],
      "env": {}
    }
  }
}

Technical Details

The analyzer is built using:

• TypeScript for type-safe code
• Tree-sitter for robust C++ parsing
• Model Context Protocol SDK for AI assistant integration
• Glob for file pattern matching

Key dependencies:

• @modelcontextprotocol/create-server: ^0.1.0
• tree-sitter: ^0.20.1
• tree-sitter-cpp: ^0.20.0
• glob: ^8.1.0

Usage

Before using any analysis tools, you must first set either the Unreal Engine source path or a custom codebase path:

Setting Up Analysis

For Unreal Engine Source Code

{
  "name": "set_unreal_path",
  "arguments": {
    "path": "/path/to/UnrealEngine/Source"
  }
}

For Custom C++ Codebases

{
  "name": "set_custom_codebase",
  "arguments": {
    "path": "/path/to/your/codebase"
  }
}

The custom codebase feature allows you to analyze any C++ project. For example:

• Game engines (Unity, Godot, custom engines)
• Graphics libraries (OpenGL, Vulkan, DirectX)
• Frameworks (Qt, Boost, SFML)
• Any C++ application or library

Example analyzing a custom game engine:

// Initialize with custom codebase
{
  "name": "set_custom_codebase",
  "arguments": {
    "path": "/path/to/game-engine"
  }
}

// Analyze engine's renderer class
{
  "name": "analyze_class",
  "arguments": {
    "className": "Renderer"
  }
}

// Find all shader-related code
{
  "name": "search_code",
  "arguments": {
    "query": "shader|glsl|hlsl",
    "filePattern": "*.{h,cpp,hpp}"
  }
}

// Get render system class hierarchy
{
  "name": "find_class_hierarchy",
  "arguments": {
    "className": "RenderSystem",
    "includeImple

... [View full README on GitHub](https://github.com/ayeletstudioindia/unreal-analyzer-mcp#readme)