ayeletstudioindia/unreal-analyzer-mcp

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:
bash
git clone https://github.com/ayeletstudioindia/unreal-analyzer-mcp
cd unreal-analyzer-mcp
2. Install dependencies:
bash
npm install
3. Build the project:
bash
npm run build
## Configuration
### For Claude Desktop App
Add the following to your Claude desktop configuration file (%APPDATA%\Claude\claudedesktopconfig.json on Windows):
json
"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\clinemcpsettings.json on Windows):
json
"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
typescript
"name": "setunrealpath",
"arguments": {
"path": "/path/to/UnrealEngine/Source"
#### For Custom C++ Codebases
typescript
"name": "setcustomcodebase",
"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:
typescript
// Initialize with custom codebase
"name": "setcustomcodebase",
"arguments": {
"path": "/path/to/game-engine"
// Analyze engine's renderer class
"name": "analyzeclass",
"arguments": {
"className": "Renderer"
// Find all shader-related code
"name": "searchcode",
"arguments": {
"query": "shader|glsl|hlsl",
"filePattern": ".{h,cpp,hpp}"
// Get render system class hierarchy
"name": "findclasshierarchy",
"arguments": {
"className": "RenderSystem",
"includeImplementedInterfaces": true