UE‑MCP – Unreal Engine 모델 컨텍스트 프로토콜 서버

정의 – C++ 브리지 플러그인을 통해 AI 어시스턴트가 Unreal Editor와 통신할 수 있게 하는 Node.js/TypeScript 서버입니다. 약 2,040개의 에디터 작업(레벨, 블루프린트, 머티리얼, VFX, PCG 등)을 JSON‑RPC 호출로 노출하여 자연어 명령으로 UE 5 프로젝트를 생성, 읽기 또는 수정할 수 있습니다.

작동 방식

• ue-mcp는 UE 프로젝트에 작은 C++ 플러그인을 설치하고 WebSocket‑JSON‑RPC 서버를 시작합니다.
• AI 클라이언트는 일반 영어(또는 구조화된) 명령을 보내고, 서버는 브리지를 통해 이를 UE API 호출로 변환합니다.
• 작업은 ue-mcp.yml YAML 흐름에서도 구성할 수 있어 다단계 반복 가능한 워크플로를 지원합니다.
• npm 기반 플러그인 시스템을 통해 개발자는 새 작업이나 전체 카테고리를 추가할 수 있습니다.

주요 기능

• 29개 도구 카테고리 – 레벨 레이아웃부터 애니메이션, Niagara, PCG, GAS, 네트워킹, 새로운 UE 5.8 네이티브 도구 세트까지 포괄합니다.
• 내장 19단계 데모 – 브리지만으로 "Neon Shrine" 장면을 절차적으로 생성합니다.
• 안전 가드 – 쓰기 보호, 소스 제어 검사, 흐름 롤백으로 프로젝트를 보호합니다.
• 확장 가능 – 새 작업을 주입하는 npm 플러그인(ue-mcp-<plugin>)을 게시할 수 있습니다.
• YAML 흐름 – 재시도, 롤백, 사용자 지정 JS/TS 작업이 포함된 반복 가능한 파이프라인을 정의합니다.
• 크로스 플랫폼 – Windows, macOS, Linux(UE 5.4‑5.8)에서 작동합니다.

일반적인 사용 사례

• 대규모 언어 모델(예: Claude, Cursor)이 레벨, 에셋, 게임플레이 시스템을 반복적으로 설계하도록 합니다.
• 반복적인 에디터 작업(일괄 가져오기, 머티리얼 생성, 빌드 파이프라인)을 자동화합니다.
• 수동 UI 작업 없이 절차적 콘텐츠 생성 파이프라인을 프로토타입합니다.
• 게임 개발 스튜디오 도구 내에서 AI 기반 "어시스턴트" 기능을 제공합니다.

시작하기

npx ue-mcp init   # .uproject 감지, 브리지 배포, 필요한 UE 플러그인 활성화
npx ue-mcp doctor # 연결 문제 해결

에디터를 다시 시작한 후 다음 명령을 보냅니다:

"플레이어 시작 지점 위 300 유닛에 포인트 라이트를 배치, 강도 5000."
"Development 구성으로 프로젝트를 빌드하고 컴파일 오류를 보고하세요."

설치 요구 사항

• Unreal Engine 5.4‑5.8(Windows) 또는 5.6+(Linux/macOS).
• Node 18+.
• C++ 툴체인(Windows의 Visual Studio, macOS의 Xcode CLI, Linux의 gcc/clang).
• PythonScriptPlugin(UE에 번들) – init에 의해 자동 활성화됩니다.

문서 및 커뮤니티

• 전체 문서: https://ue-mcp.com/docs(시작 가이드, 도구 참조, 흐름, 플러그인, 문제 해결).
• MIT 라이선스, 스폰서 환영, PR 및 이슈 수락.

제한 사항 / 고려 사항

• 컴파일된 C++ 브리지가 필요합니다. 에디터를 다시 시작하지 않거나 툴체인이 없으면 첫 실행이 실패할 수 있습니다.
• 쓰기 액세스는 AI가 프로젝트 파일을 완전히 제어할 수 있게 합니다 – 안전 가드는 선택 사항이지만 권장됩니다.
• UE 5만 지원합니다. 이전 엔진 버전은 지원되지 않습니다.

라이선스 – MIT(개인, 교육, 상업용 무료).