uefn-mcp
uefn-ai-toolkit
UEFNエディタを手でクリック操作する代わりに、Claudeに説明してFortniteマップをビルドします。
これはClaude Codeプラグインで、3つのパーツで構成されています。EpicのPythonリモート実行プロトコルを介して実行中のUEFNエディタを操作するMCPサーバー、スキルセット、そしてFortnite Creativeで実際に機能するもののナレッジベースです。どのアセットが公開しても安全か、どのデバイス設定がスクリプト可能か、どのルートが有望に見えて行き止まりなのかがまとめられています。
必要なもの
UEFNがインストールされ、プロジェクトが作成されていること。
PATHに
uvがあること(サーバーはPythonです)。
Related MCP server: Unreal-MCP-Ghost
インストール
/plugin marketplace add dylannalex/uefn-ai-toolkit
/plugin install uefn-ai-toolkit@dylannalex-uefn次に新しいClaude Codeセッションを開始してください。MCPサーバーはセッション開始時にのみ接続されます。プロジェクトを読み込んだUEFNを開いて、次のように尋ねます:
リモート実行用にUEFNプロジェクトをセットアップして。
Claudeはディスク上のプロジェクトを見つけ、UEFNが必要とする2つの設定(Python Scriptingとそのリモート実行)をオンにします。どちらもデフォルトではオフです。UEFNがすでに開いている場合は再起動するように指示されます。これらの設定は起動時にのみ読み込まれるためです。
使い方
やりたいことを説明します:
レベルに現在配置されているすべてのものを表示して
マップの中央にチェストをスポーンして、中にアサルトライフルを入れて
"SpawnPoint_1" を200ユニット上に移動して
上からマップのスクリーンショットを撮って、見えるようにして
レベル内に公開に失敗するものがないか確認して
UnrealやPythonを知っている必要はありません。Claudeがデバイスやプロップの名前を知らない場合は、コンテンツブラウザで検索できます。
セッション間でメモを保持する
Claudeは会話間でエディタの記憶を持ちません。また、.uefnprojectはバイナリ形式のため、diffやレビューができません。マッププロジェクトを依頼すると、プラグインはマップの横にmarkdownのプレーンなgitリポジトリをスキャフォールドします。デザイン、現在構築されているもの、まだ保留中のもの、ビルドログが含まれます。
新しいマップ用のプロジェクトフォルダをセットアップして
そのリポジトリはあなたのもので、プラグインファイルは含まれていません。そのため、プラグインを更新してもノートには一切触れません。
知っておくべき制限
一度に1つのエディタのみ。 Discoveryは最初に見つけたUEFNインスタンスに接続するため、開いているのは1つにしてください。現在は複数のClaude Codeセッションを同時に実行できます。各セッションが独自のコマンドポートを取得します。
Verseのコンパイルは手動クリックが必要です。
Verse > Build Verse Codeにはスクリプト可能なトリガーがありません。コンパイル以降のすべては自動化されていますが、コンパイル自体は自動化されていません。アイテムコンテンツはItem Spawner V3でのみスクリプト可能です。 Item GranterとClass Designerは、そのアイテムコンテンツをプラットフォームの壁の背後に保持しています。これは回避策を取るのではなく文書化されているため、誰もセッションを費やして再発見することはありません。
Claudeは配置されたものをWorld Outliner名で見つけるため、明確で一意なラベルが役立ちます。
仕組み
ナレッジベースのルーティングテーブルについては skills/uefn-knowledge/SKILL.md を、アーキテクチャ、ワイヤープロトコル、エンドツーエンドでトレースされたツール呼び出しについては docs/internals/INDEX.md を参照してください。
Available Tools
11 toolsdelete_actorA
Delete the actor with the given editor label (World Outliner name).
Inputs: label (required).
duplicate_actorA
Duplicate the actor with the given label, optionally offsetting the copy's world location and giving it a new editor label.
Inputs: label (required), offset, new_label.
execute_pythonA
Run arbitrary Python code inside the UEFN editor's unreal module.
Use this to explore the editor when the dedicated tools aren't enough:
e.g. browsing content with unreal.EditorAssetLibrary, inspecting
Fortnite device/actor classes, or calling APIs not wrapped by other tools.
Args: code: Python source to run. For "statement"/"eval" it must be a single expression/statement; for "file" (default) it can be a full multi-line script. mode: One of "file" (default, runs as a script), "statement" (executes and prints one statement), or "eval" (evaluates one expression and returns its value).
Returns:
dict with success (bool), result (the eval'd value or error
text as a string), and output (anything printed/logged).
Inputs: code (required), mode.
get_actor_transformA
Get the world transform (location/rotation/scale) of the actor with the given label.
Inputs: label (required).
get_editor_statusA
Check connectivity and report basic info about the connected UEFN editor (project file, current level name, engine version, actor/selection counts).
Inputs: no named parameters.
get_selected_actorsA
Return the actors currently selected in the UEFN editor viewport/outliner.
Inputs: no named parameters. Returns: result
list_actorsA
List actors currently placed in the loaded level.
Args: class_name: If set, only return actors whose class name contains this substring (case-insensitive), e.g. "StaticMeshActor". limit: Maximum number of actors to return.
Inputs: limit, class_name. Returns: result
list_content_assetsA
Browse assets in the content browser (props, Blueprints, materials, etc.).
Args: path: Content path to search, e.g. "/Game" or "/Game/Devices". class_names: If set, only return assets whose class name is in this list (e.g. ["StaticMesh", "Blueprint"]). recursive: Whether to search subfolders. limit: Maximum number of assets to return.
Inputs: path, limit, recursive, class_names. Returns: result
save_levelA
Save the current level. If all_dirty is True, saves all dirty levels instead.
Inputs: all_dirty.
set_actor_transformA
Move/rotate/scale the actor with the given label. Any of location, rotation, or scale left unset is left unchanged.
Inputs: label (required), scale, location, rotation.
spawn_actorA
Spawn an actor into the loaded level.
Args:
class_path: Object path of the class to spawn. Either a native class
(e.g. "/Script/Engine.StaticMeshActor") or a Blueprint class
asset path (e.g. "/Game/Devices/BP_MyDevice.BP_MyDevice"). Use
list_content_assets or execute_python to discover available
Fortnite device/prop Blueprint paths.
location: World location {"x", "y", "z"} in cm. Defaults to origin.
rotation: World rotation {"pitch", "yaw", "roll"} in degrees.
scale: Actor scale {"x", "y", "z"}. Defaults to (1, 1, 1).
label: Optional editor display name (shown in the World Outliner).
Inputs: class_path (required), label, scale, location, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools have clearly distinct purposes, but list_actors and get_selected_actors overlap somewhat in returning actor information, and execute_python is a catch-all that could be confused with dedicated tools if misused. Descriptions are clear enough to resolve ambiguity.
All tool names follow a consistent verb_noun pattern with snake_case, using predictable verbs like list, get, set, delete, spawn, duplicate, and save. No mixed conventions or vague naming.
11 tools is well within the ideal 3-15 range for a UEFN editor server. Each tool covers a distinct editor operation without unnecessary bloat, making the surface manageable and focused.
The tool set covers core actor lifecycle (spawn, read, update, delete, duplicate), saving, content browsing, and editor status. Missing operations like property editing or asset creation are mitigated by the execute_python escape hatch, which allows arbitrary editor access.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- AlicenseBqualityCmaintenanceAn MCP server that gives AI agents broad control over Unreal Engine 5.7, enabling actor/asset/level management, Blueprint and material creation, screenshots, automation, and arbitrary editor Python execution.35MIT
- AlicenseCqualityCmaintenanceEnables AI clients to control Unreal Engine 5 editor for automated Blueprint authoring, level inspection, actor spawning, and other editor workflows via a local Python MCP server and UE plugin.5004AGPL 3.0
- AlicenseNot gradedqualityAmaintenanceExposes the Unreal Editor for Fortnite to AI assistants via MCP, enabling actor manipulation, device property editing, Verse building, and more through a Python bridge.3GPL 3.0
- AlicenseBqualityCmaintenanceAn MCP server that lets an AI agent drive Unreal Engine 5: create projects, import assets, build levels and Blueprints, configure replication, compile C++, run Play In Editor and package the game.100187 PyPI6MIT