uefn-mcp
uefn-ai-toolkit
Fortnite 맵을 UEFN 에디터를 직접 클릭하는 대신 Claude에게 설명하여 빌드하세요.
이것은 세 부분으로 구성된 Claude Code 플러그인입니다: 실행 중인 UEFN 에디터를 Epic의 Python 원격 실행 프로토콜을 통해 구동하는 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에 필요한 두 가지 설정 — Python Scripting과 그에 대한 원격 실행 — 을 켭니다. 둘 다 기본적으로 꺼져 있습니다. UEFN이 이미 열려 있었다면 다시 시작하라는 메시지가 표시됩니다. 이러한 설정은 시작 시에만 읽히기 때문입니다.
사용 방법
원하는 것을 설명하세요:
내 레벨에 현재 배치된 모든 것을 보여줘
맵 중앙에 상자를 생성하고 그 안에 돌격 소총을 넣어줘
"SpawnPoint_1"을 200유닛 위로 이동시켜줘
맵을 위에서 스크린샷 찍어서 볼 수 있게 해줘
내 레벨에 게시에 실패할 것이 있는지 확인해줘
Unreal이나 Python을 알 필요는 없습니다. Claude가 디바이스나 소품의 이름을 모르면 콘텐츠 브라우저에서 검색할 수 있습니다.
세션 간 메모 유지
Claude는 대화 사이에 에디터에 대한 기억이 없으며, .uefnproject는 바이너리이므로 diff나 리뷰가 불가능합니다. 맵 프로젝트를 요청하면 플러그인이 맵과 함께 일반 git 저장소에 마크다운을 생성합니다: 디자인, 현재 빌드된 것, 아직 보류 중인 것, 그리고 빌드 로그입니다.
새 맵을 위한 프로젝트 폴더를 설정해 줘
그 저장소는 여러분의 것이며 플러그인 파일을 포함하지 않으므로 플러그인을 업데이트해도 메모에는 영향을 미치지 않습니다.
알아두면 좋은 제한 사항
한 번에 하나의 에디터만. Discovery는 먼저 찾은 UEFN 인스턴스에 연결되므로 하나만 열어 두세요. 이제 여러 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