DL

db-lyon/ue-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

461 stars 72 forks 품질 83 트렌드 43MIT

db-lyon/ue-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

db-lyon/ue-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

언리얼 엔진 모델 컨텍스트 프로토콜 서버 - 2040+ 액션을 커버하는 29개의 카테고리 도구를 통해 AI 어시스턴트에게 언리얼 에디터에 대한 깊은 읽기/쓰기 권한을 제공하며, 다단계 워크플로우를 위한 YAML 플로우 엔진과 서피스 확장을 위한 npm 플러그인 시스템을 제공합니다.

이 합계는 ue-mcp 자체 1210+ 액션과 Epic 전체 네이티브 AI 툴셋 레지스트리를 포함합니다: UE 5.8+에서는 830개의 공식 언리얼 툴이 in-process로 불리며, 매칭 카테고리에서는 epic_* 액션, animation에는 시퀀서, pcg에는 PCG, asset에는 정적 메시로 표시됩니다.

블루프린트, 재질, 레벨, 액터, 애니메이션, VFX, 지형, PCG, 식생, 오디오, UI, 물리, 내비게이션, AI, StateTree, GAS, 네트워킹, 시퀀서, 빌드 파이프라인 - 모두 자연어를 통해 프로그래밍 가능해요.

파일 시스템 읽기(INI 설정, C++ 헤더, 자산 목록)는 편집기를 닫아둔 상태에서 작동하므로, 에이전트가 실행 전에 프로젝트를 탐색할 수 있습니다.

퀵 스타트

상호작용 환경은 다음과 같습니다:

  1. .uproject 찾기 (현재 디렉터리에서 자동 감지)
  2. 어떤 도구 카테고리를 활성화할지 선택할 수 있게 합니다
  3. C++ 브리지 플러그인을 프로젝트에 배포하세요
  4. 필요한 UE 플러그인(나이아가라, PCG, GAS 등) 활성화

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

UE-MCP

Unreal Engine Model Context Protocol Server - gives AI assistants deep read/write access to the Unreal Editor through 30 category tools covering 2114+ actions, plus a YAML flow engine for multi-step workflows and an npm plugin system for extending the surface.

That total is 1284+ actions of ue-mcp’s own plus Epic’s entire native AI Toolset Registry: on UE 5.8+ its 830 official Unreal tools are called in-process and surfaced as epic_* actions in the matching category, Sequencer in animation, PCG in pcg, static meshes in asset.

flowchart LR
    AI[AI Assistant] -->|stdio| MCP[MCP ServerTypeScript / Node.js]
    MCP -->|WebSocketJSON-RPC| Plugin[C++ Bridge Plugininside Unreal Editor]
    Plugin -->|UE API| Editor[Editor Subsystems]
    MCP -->|direct fs| FS[Config INIC++ HeadersAsset Listing]

Blueprints, materials, levels, actors, animation, VFX, landscape, PCG, foliage, audio, UI, physics, navigation, AI, StateTree, GAS, networking, sequencer, build pipeline - all programmable through natural language.

Filesystem reads (INI config, C++ headers, asset listing) work with the editor closed, so an agent can explore the project before anything is running.

Quick Start

npx ue-mcp init

The interactive setup will:

  1. Find your .uproject (auto-detects in current directory)
  2. Let you choose which tool categories to enable
  3. Deploy the C++ bridge plugin to your project
  4. Enable required UE plugins (Niagara, PCG, GAS, etc.)
  5. Detect and configure your MCP client (Claude Code, Claude Desktop, Cursor, Codex)

Restart the editor once after setup to load the bridge plugin. To update later, run npx ue-mcp update from the project directory. It updates the npm package, redeploys the C++ plugin and rebuilds it.

Then talk to your AI in plain English:

"Check the UE-MCP connection and tell me what's in the current level."
"Place a point light 300 units above the player start, intensity 5000, warm white."
"Create an emissive material that pulses, and apply it to every cube in the level."
"Build the project in Development and report any compile errors."
GitHub에서 전체 README 보기

설치

npx -y --min-release-age=0 ue-mcp@latest C:/path/to/MyGame.uproject
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "ue-mcp": { "command": "npx", "args": ["-y", "--min-release-age=0", "ue-mcp@latest", "C:/path/to/MyGame.uproject"] } } }