ChiR24/Unreal_mcp

해결하는 문제

이 프로젝트는 AI 어시스턴트(Claude, Cursor 또는 VS Code 등)와 Unreal Engine 편집기 사이의 브리지를 제공합니다. AI가 편집기와 직접 상호 작용하여 레벨 구축, 블루프린트 생성, UI 설계, 머티리얼 설정 및 게임플레이 시스템 관리를 가능하게 하여 사용자가 엔진에서 모든 작업을 수동으로 수행할 필요가 없습니다.

작동 방식

이 시스템은 Unreal Engine 내부에서 실행되는 MCP Automation Bridge라는 네이티브 C++ 편집기 플러그인으로 구성됩니다. AI 클라이언트는 Model Context Protocol (MCP)을 사용하여 두 가지 경로를 통해 이 플러그인에 연결합니다.

• 경로 A(네이티브 HTTP): 클라이언트는 플러그인의 HTTP 서버(기본 포트 3000)에 직접 연결하고 인증에 기능 토큰을 사용합니다.
• 경로 B(stdio): 클라이언트는 Node.js 서버(unreal-engine-mcp-server)를 통해 연결하며, 이 서버는 stdio 및 WebSockets(기본 포트 8090)를 통해 프록시 역할을 합니다.

이 플러그인은 수백 개의 개별 도구를 노출하는 대신 단일 unreal 도구를 노출합니다. AI 어시스턴트는 게이트웨이 흐름을 사용합니다. 기능(예: "액터 스폰")을 검색하고, 필요한 매개변수를 얻기 위해 특정 작업을 설명한 다음 작업을 실행합니다.

대상 사용자

Unreal Engine 5.0~5.8을 사용하는 게임 개발자 및 테크니컬 아티스트로, 편집기 작업을 자동화하거나 AI를 사용하여 레벨 디자인, 블루프린팅 및 월드 구축 프로세스를 가속화하려는 사람들.

주요 특징

• 광범위한 기능: 레벨, 액터, 블루프린트, UI, UMG, 머티리얼, Niagara 효과 및 AI 행동 트리에 걸친 약 400개의 편집기 작업.
• 유연한 연결성: 다양한 AI 클라이언트를 수용하기 위해 직접 HTTP 및 stdio 전송을 모두 지원.
• 네이티브 통합: 게임 스레드에서 편집기 API에 대한 깊은 액세스를 보장하기 위해 C++ 플러그인으로 구축.
• 안전 메커니즘: 파괴적인 작업은 실수로 삭제되는 것을 방지하기 위해 특정 동의 부여가 필요.
• AI 친화적 검색: AI가 수백 개의 도구 이름을 기억할 필요가 없도록 검색 기반 시스템을 사용.