Unreal Engine コードアナライザー MCP サーバー

Unreal Engineのコードベースに強力なソースコード解析機能を提供するModel Context Protocol（MCP）サーバー。このツールにより、ClaudeやClineといったAIアシスタントはUnreal Engineのソースコードを深く理解し、解析できるようになります。

特徴

クラス分析: メソッド、プロパティ、継承を含む C++ クラスの詳細情報を取得します。
階層マッピング: クラスの継承階層を視覚化して理解する
コード検索: コンテキストに応じた結果でコードを検索します
参照の検索: クラス、関数、変数へのすべての参照を検索します
サブシステム分析: レンダリング、物理などの主要な Unreal Engine サブシステムを分析します。
ゲームジャンル知識: ゲームのジャンル、機能、実装パターンに関する知識ベースが組み込まれています
パターン検出と学習: 一般的な Unreal Engine パターンを識別し、学習リソースを提供します
カスタムコードベースサポート: 独自の Unreal Engine プロジェクトのコードベースを分析します

クイックスタート

インストール

このリポジトリをクローンします:

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

依存関係をインストールします:

npm install

プロジェクトをビルドします。

npm run build

構成

Claudeデスクトップアプリ

Claude デスクトップ構成ファイル (Windows の場合は%APPDATA%\Claude\claude_desktop_config.json ) に次のコードを追加します。

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

クラインのために

Cline MCP 設定ファイル (Windows の場合は%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json ) に以下を追加します。

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

技術的な詳細

アナライザーは以下を使用して構築されます:

型安全なコードのためのTypeScript
堅牢な C++ 解析のための Tree-sitter
AIアシスタント統合のためのモデルコンテキストプロトコルSDK
ファイルパターンマッチングのためのGlob

主な依存関係:

@modelcontextprotocol/create-server: ^0.1.0
木に座っている人: ^0.20.1
ツリーシッターcpp: ^0.20.0
グロブ: ^8.1.0

使用法

分析ツールを使用する前に、まず Unreal Engine ソースパスまたはカスタムコードベースパスのいずれかを設定する必要があります。

分析の設定

Unreal Engineソースコード

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

カスタムC++コードベースの場合

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

カスタムコードベース機能を使用すると、あらゆるC++プロジェクトを分析できます。例えば：

ゲームエンジン（Unity、Godot、カスタムエンジン）
グラフィックライブラリ（OpenGL、Vulkan、DirectX）
フレームワーク（Qt、Boost、SFML）
任意のC++アプリケーションまたはライブラリ

カスタムゲームエンジンを分析する例:

// 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",
    "includeImplementedInterfaces": true
  }
}

Qt アプリケーションを分析する例:

// Initialize with Qt project
{
  "name": "set_custom_codebase",
  "arguments": {
    "path": "/path/to/qt-app"
  }
}

// Find widget class definitions
{
  "name": "search_code",
  "arguments": {
    "query": "class.*:.*public.*QWidget",
    "filePattern": "*.h"
  }
}

// Analyze main window class
{
  "name": "analyze_class",
  "arguments": {
    "className": "MainWindow"
  }
}

// Find signal/slot connections
{
  "name": "find_references",
  "arguments": {
    "identifier": "connect",
    "type": "function"
  }
}

利用可能なツール

1. クラス分析

// Get detailed information about the AActor class
{
  "name": "analyze_class",
  "arguments": {
    "className": "AActor"
  }
}

出力例:

{
  "name": "AActor",
  "properties": [
    {
      "name": "RootComponent",
      "type": "USceneComponent*",
      "access": "protected"
    }
    // ... other properties
  ],
  "methods": [
    {
      "name": "BeginPlay",
      "returnType": "void",
      "access": "protected",
      "virtual": true
    }
    // ... other methods
  ]
}

2. クラス階層分析

// Get the inheritance hierarchy for ACharacter
{
  "name": "find_class_hierarchy",
  "arguments": {
    "className": "ACharacter",
    "includeImplementedInterfaces": true
  }
}

出力例:

{
  "class": "ACharacter",
  "inheritsFrom": "APawn",
  "interfaces": ["IMovementModeInterface"],
  "hierarchy": [
    "ACharacter",
    "APawn",
    "AActor",
    "UObject"
  ]
}

3. 参考文献の発見

// Find all references to the BeginPlay function
{
  "name": "find_references",
  "arguments": {
    "identifier": "BeginPlay",
    "type": "function"
  }
}

出力例:

{
  "references": [
    {
      "file": "Actor.cpp",
      "line": 245,
      "context": "void AActor::BeginPlay() { ... }"
    },
    {
      "file": "Character.cpp",
      "line": 178,
      "context": "Super::BeginPlay();"
    }
  ]
}

4. コード検索

// Search for physics-related code
{
  "name": "search_code",
  "arguments": {
    "query": "PhysicsHandle",
    "filePattern": "*.h",
    "includeComments": true
  }
}

出力例:

{
  "matches": [
    {
      "file": "PhysicsEngine/PhysicsHandleComponent.h",
      "line": 15,
      "context": "class UPhysicsHandleComponent : public UActorComponent",
      "snippet": "// Component used for grabbing and moving physics objects"
    }
  ]
}

5. パターン検出とベストプラクティス

アナライザーには、Unreal Engine のベストプラクティスを理解して従うための 2 つの強力なツールが用意されています。

パターン検出

// Detect patterns in a file
{
  "name": "detect_patterns",
  "arguments": {
    "filePath": "Source/MyGame/MyActor.h"
  }
}

出力例:

{
  "patterns": [
    {
      "pattern": "UPROPERTY Macro",
      "description": "Property declaration for Unreal reflection system",
      "location": "Source/MyGame/MyActor.h:15",
      "context": "UPROPERTY(EditAnywhere, BlueprintReadWrite)\nfloat Health;",
      "improvements": "Consider adding a Category specifier for better organization\nConsider adding Meta tags for validation",
      "documentation": "https://docs.unrealengine.com/5.0/en-US/unreal-engine-uproperty-specifier-reference/",
      "bestPractices": "Use appropriate specifiers (EditAnywhere, BlueprintReadWrite)\nConsider replication needs (Replicated, ReplicatedUsing)\nGroup related properties with categories",
      "examples": "UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = \"Combat\")\nfloat Health;\nUPROPERTY(Replicated, Meta = (ClampMin = \"0.0\"))\nfloat Speed;"
    }
  ]
}

ベストプラクティスガイド

// Get best practices for specific Unreal concepts
{
  "name": "get_best_practices",
  "arguments": {
    "concept": "UPROPERTY"  // or UFUNCTION, Components, Events, Replication, Blueprints
  }
}

出力例:

{
  "description": "Property declaration for Unreal reflection system",
  "bestPractices": [
    "Use appropriate specifiers (EditAnywhere, BlueprintReadWrite)",
    "Consider replication needs (Replicated, ReplicatedUsing)",
    "Group related properties with categories",
    "Use Meta tags for validation and UI customization"
  ],
  "examples": [
    "UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = \"Combat\")\nfloat Health;",
    "UPROPERTY(Replicated, Meta = (ClampMin = \"0.0\"))\nfloat Speed;"
  ],
  "documentation": "https://docs.unrealengine.com/5.0/en-US/unreal-engine-uproperty-specifier-reference/"
}

ベストプラクティスガイドでは、Unreal Engine の主要な概念について説明します。

UPROPERTY: 不動産の反映と露出
UFUNCTION: 関数リフレクションとブループリントの統合
コンポーネント: コンポーネントの作成と管理
イベント: イベント処理と委任
レプリケーション: ネットワークレプリケーションのセットアップ
ブループリント: ブループリント/C++ のインタラクションパターン

6. APIドキュメントクエリ

// Search the API documentation
{
  "name": "query_api",
  "arguments": {
    "query": "Actor",
    "category": "Object",
    "module": "Core",
    "includeExamples": true,
    "maxResults": 10
  }
}

出力例:

{
  "results": [
    {
      "class": "AActor",
      "description": "Base class for all actors in the game",
      "module": "Core",
      "category": "Object",
      "syntax": "class AActor : public UObject",
      "examples": [
        "// Create a new actor\nAActor* MyActor = GetWorld()->SpawnActor<AActor>();"
      ],
      "remarks": [
        "Actors are the base building blocks of the game",
        "Can be placed in levels or spawned dynamically"
      ],
      "documentation": "https://dev.epicgames.com/documentation/en-us/unreal-engine/API/Core/AActor",
      "relevance": 100
    }
  ]
}

API ドキュメントクエリツールは以下を提供します。

クラスドキュメント全体の全文検索
カテゴリとモジュールによるフィルタリング
コード例と使用パターン
関連性に基づいた結果の並べ替え
公式ドキュメントへのリンク

7. サブシステム分析

// Analyze the Physics subsystem
{
  "name": "analyze_subsystem",
  "arguments": {
    "subsystem": "Physics"
  }
}

出力例:

{
  "name": "Physics",
  "coreClasses": [
    "UPhysicsEngine",
    "FPhysScene",
    "UBodySetup"
  ],
  "keyFeatures": [
    "PhysX integration",
    "Collision detection",
    "Physical materials"
  ],
  "commonUseCases": [
    "Character movement",
    "Vehicle simulation",
    "Destructible environments"
  ]
}

APIドキュメント

アナライザーには、包括的な API ドキュメント機能が含まれるようになりました。

自動ドキュメント生成
- ソースコードのコメントからドキュメントを抽出します
- 階級構造と関係を分析する
- クラスをタイプとモジュール別に分類します
- 構文例と使用パターンを生成する
スマート検索
- すべてのドキュメントの全文検索
- 関連性に基づいた結果のランキング
- カテゴリとモジュールのフィルタリング
- コード例の組み込み
ドキュメントのカテゴリ
- オブジェクト: 基本オブジェクトクラス (UObject 派生クラス)
- アクター: アクタークラス (AActor 派生クラス)
- 構造: データ構造と型
- コンポーネント: コンポーネントクラス
- その他: その他のクラスとユーティリティ
モジュール構成
- コア: コアエンジン機能
- RenderCore: レンダリングシステム
- PhysicsCore: 物理エンジン
- その他のエンジンモジュール
既存のツールとの統合
- 詳細情報についてはクラス分析へのリンクをご覧ください
- ベストプラクティスのためのパターン検出に接続
- 公式のUnreal Engineドキュメントを参照
- 学習リソースと例を提供します

ベストプラクティス

分析ツールを使用する前に、必ず Unreal Engine パスまたはカスタムコードベースパスのいずれかを設定してください。
分析時には特定のクラス名を使用します（例：単に「Class」ではなく「MyClass」）
search_codeのファイルパターンパラメータを活用して結果を絞り込む
クラス階層を分析する際には実装されたインターフェースを含めて完全な理解を得る
サブシステム分析ツールを使用して、特定のクラスに進む前に概要を把握します (Unreal Engine のみ)

エラー処理

アナライザーは、次の場合に明確なエラーメッセージを表示します。

コードベースパスが設定されていません (Unreal Engine またはカスタム)
指定されたパスは存在しないかアクセスできません
コードベースにクラスまたはシンボルが見つかりません
無効なファイルパターンが指定されました
検索クエリまたはC++コードの構文エラー
ソースファイルへのアクセスは制限されています
C++ ファイルの Tree-sitter 解析が失敗する

パフォーマンスに関する考慮事項

大規模なコードベースでは分析に時間がかかる場合があります
複雑なクラス階層では処理に時間がかかる場合があります
幅広い検索パターンでは多くの一致が見つかる可能性がある
より早く結果を得るために、より具体的なクエリの使用を検討してください

テスト

このプロジェクトには、すべての主要コンポーネントに対する包括的なテストが含まれています。

テスト範囲

アナライザーテスト: UnrealCodeAnalyzer クラスのコア機能テスト
- 初期化とパス検証
- クラス分析と解析
- 参考文献
- コード検索
- サブシステム分析
- キャッシュ管理
ゲームジャンルテスト：ゲームジャンル知識ベースの検証
- データ構造の検証
- ジャンル固有の機能検証
- コンポーネントの命名規則
- データの完全性チェック
MCP サーバーテスト: MCP サーバー実装のテスト
- サーバーの初期化
- ツールの登録と取り扱い
- リクエスト/レスポンスの検証
- エラー処理
- ツール固有の機能テスト

テストの実行

すべてのテストを実行します。

npm test

ウォッチモードでテストを実行します (開発中に便利です):

npm run test:watch

テストを書く

新しい機能を提供する際は、次の点に注意してください。

すべての新機能には対応するテストカバレッジがあります
テストはsrc/__tests__ディレクトリに整理されます
外部依存関係を適切にモックする
一貫性を保つために既存のテストパターンに従う

貢献

貢献を歓迎します！改善点があれば、お気軽にプルリクエストを送信してください。

ソースコード解析機能
新しい分析機能
パフォーマンスの最適化
ドキュメントの改善
テスト範囲

PR を送信する前に:

すべてのテストが合格することを確認する（ npm test ）
新しい機能のテストを追加する
必要に応じてドキュメントを更新する

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Unreal Engine コードベースの詳細なソースコード分析を提供し、AI アシスタントが C++ クラス構造を理解し、コードを検索し、サブシステムを分析できるようにします。

Related Resources

Reddit Discussion about this server

Related MCP Servers

CodeSavant
twolven
-
security
A
license
-
quality
Provides code manipulation, execution, and version control capabilities. It allows AI assistants to read, write, and execute code while maintaining a history of changes.
Last updated -
8
Python
MIT License
DeepSeek MCP Server
Sheshiyer
-
security
F
license
-
quality
Provides code generation and completion capabilities using the DeepSeek API, with support for tool chaining and cost optimization.
Last updated -
3
JavaScript
IDA Pro MCP Server
fdrechsler
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with IDA Pro for reverse engineering and binary analysis tasks.
Last updated -
8
14
Python
MIT License
Binary Ninja MCP
fosdickio
-
security
A
license
-
quality
A server that enables seamless integration of Binary Ninja's reverse engineering capabilities with LLM assistance, allowing AI tools like Claude to interact with binary analysis features in real-time.
Last updated -
42
Python
GPL 3.0

View all related MCP servers