db-lyon/ue-mcp

해결하는 문제

UE-MCP는 AI 어시스턴트가 Unreal Engine 에디터와 직접 상호작용할 수 있도록 합니다. 자연어 요청을 복잡한 에디터 작업으로 수동으로 변환하는 번거로움을 제거하고, AI 에이전트가 레벨을 구축하고, 재질을 작성하며, Blueprint를 생성하고, 프로젝트 자산을 관리할 수 있도록 프로그래머블 인터페이스를 제공합니다.

작동 방식

이 프로젝트는 Model Context Protocol (MCP)를 구현하여 AI 클라이언트(Claude 또는 Cursor 등)와 Unreal 에디터 사이의 다리를 구축합니다. TypeScript/Node.js로 작성된 서버가 WebSocket/JSON-RPC를 통해 Unreal 에디터 내부에 설치된 C++ 브리지 플러그인과 통신합니다. 이 구조를 통해 에디터가 열려 있지 않아도 C++ 헤더 파일과 INI 설정 파일에 직접 파일 시스템 접근이 가능하며, 24개 카테고리에 걸쳐 1,000개 이상의 작업을 수행할 수 있습니다.

대상 사용자

Unreal Engine 5.4–5.8을 사용하고 있으며, 에디터 작업을 자동화하거나 AI를 통해 콘텐츠를 절차적으로 생성하거나 반복적인 기술적 설정을 AI 에이전트에게 위임하고자 하는 게임 개발자 및 테크니컬 아티스트를 위한 것입니다.

주요 특징

• 심층 에디터 접근: Niagara VFX, PCG 그래프, Gameplay Ability System (GAS), StateTree까지 모든 요소를 제어 가능.
• YAML 워크플로우: YAML로 정의된 다단계 워크플로우를 지원하며, 핫리로드 가능하고 롤백 기능도 제공.
• 네이티브 툴셋 통합: UE 5.8+의 Epic 공식 AI 툴셋 레지스트리(UE 5.8+)를 래핑하여 수백 가지 공식 툴을 에이전트 액션으로 노출.
• 확장 가능한 아키텍처: npm 플러그인 시스템을 통해 새로운 액션을 쉽게 추가 가능.
• 안전성 가드: 쓰기 가드와 소스 컨트롤 통합을 통해 AI 에이전트가 중요한 프로젝트 데이터를 실수로 덮어쓰는 것을 방지.