Repolode
제출하기
ChiR24

ChiR24/Unreal_mcp

실행 중인 에디터에서 AI 어시스턴트가 레벨, Blueprint, 머티리얼 등을 만들 수 있게 해주는 네이티브 C++ Unreal Editor 플러그인 기반 MCP 서버입니다.

GitHub에서 보기
스타
958
포크
184
열린 이슈
15
마지막 커밋
어제

어떤 프로젝트인가요?

EngineWire는 Claude, Cursor, VS Code 같은 MCP 호환 AI 클라이언트를 실행 중인 Unreal Editor에 연결합니다. 네이티브 C++ 에디터 플러그인은 에디터의 게임 스레드에서 작업을 수행하며, TypeScript 서버는 로컬 명령만 실행하는 클라이언트를 위한 stdio 경로를 제공합니다. 두 경로 모두 검색, 설명, 실행, 구성 작업을 지원하는 단일 MCP 도구인 unreal을 제공하며, 거의 400가지 기능을 다룹니다.

기능은 레벨과 액터, Blueprint와 UMG 위젯, 머티리얼, 랜드스케이프, 폴리지, Niagara 효과, PCG 그래프, Gameplay Ability System, AI(Behavior Tree, State Tree, EQS), Level Sequence, 오디오, 패키징을 포함합니다. 매개변수를 엄격하게 검증하고, 파괴적인 작업에는 동의 허가가 필요하며, 어시스턴트가 작업 결과를 확인할 수 있도록 에디터에서 스크린샷을 찍고 Play-In-Editor 세션을 실행할 수 있습니다.

플러그인은 Unreal Engine 5.0부터 5.8까지 지원합니다. 모든 연결은 127.0.0.1에서만 수신 대기하며, 기본적으로 프로젝트별 capability token이 필요합니다.

핵심 기능

  • 01검색, 설명, 실행, 구성 작업을 지원하는 단일 MCP 도구를 제공합니다.
  • 02Streamable HTTP 또는 stdio-to-WebSocket 브리지를 통해 Unreal Editor 안에서 네이티브로 실행됩니다.
  • 03레벨, Blueprint, UMG, 머티리얼, Niagara, PCG, AI, Level Sequence를 다룹니다.
  • 04매개변수를 엄격하게 검증하며 파괴적인 작업에는 동의가 필요합니다.
  • 05기본적으로 localhost에서만 수신 대기하고 capability token을 요구합니다.

활용 사례

  • 채팅 프롬프트만으로 AI 어시스턴트가 액터를 생성하고, 조명을 배치하고, 레벨을 구성하도록 합니다.
  • Blueprint 이벤트 그래프나 UMG 위젯 레이아웃을 일괄 생성합니다.
  • 어시스턴트가 스크린샷을 찍고 Play-In-Editor 세션을 실행해 에디터 작업 결과를 확인합니다.
  • 팀에서 실행 중인 에디터 하나를 여러 MCP 클라이언트와 공유합니다.

빠른 시작

  1. 1

    Releases 페이지에서 v0.6 프리릴리스 플러그인 ZIP을 다운로드합니다

  2. 2

    EngineWire 폴더를 프로젝트의 Plugins 디렉터리에 복사합니다

    MyGame/Plugins/EngineWire/
  3. 3

    Project Settings에서 Enable Native MCP Server를 활성화한 다음 에디터를 다시 시작합니다

  4. 4

    capability token을 사용해 Claude Code에 서버를 추가합니다

    claude mcp add --transport http unreal-engine http://127.0.0.1:3000/mcp --header "X-MCP-Capability-Token: <token>"

사용 전 알아둘 점

  • Unreal Engine 5.0~5.8 및 C++ 코드가 포함된 프로젝트가 필요합니다. Blueprint 전용 프로젝트에서는 사전 빌드된 바이너리가 필요합니다.
  • 사전 빌드된 바이너리는 빌드에 사용된 것과 동일한 엔진 마이너 버전 및 플랫폼에서만 작동합니다.
  • README에는 0.6 베타 라인이 설명되어 있으며, 이전 안정 버전인 0.5.30과 도구 구성이 다릅니다.

토픽

#mcp#unreal-engine#game-development#ai-agent#blueprints#cpp#mcp-server#unreal-engine-5

자주 묻는 질문

Unreal_mcp은(는) 무엇인가요?
실행 중인 에디터에서 AI 어시스턴트가 레벨, Blueprint, 머티리얼 등을 만들 수 있게 해주는 네이티브 C++ Unreal Editor 플러그인 기반 MCP 서버입니다. EngineWire는 Claude, Cursor, VS Code 같은 MCP 호환 AI 클라이언트를 실행 중인 Unreal Editor에 연결합니다. 네이티브 C++ 에디터 플러그인은 에디터의 게임 스레드에서 작업을 수행하며, TypeScript 서버는 로컬 명령만 실행하는 클라이언트를 위한 stdio 경로를 제공합니다. 두 경로 모두 검색, 설명, 실행, 구성 작업을 지원하는 단일 MCP 도구인 unreal을 제공하며, 거의 400가지 기능을 다룹니다.
Unreal_mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Unreal_mcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Unreal_mcp은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Unreal_mcp의 마지막 커밋은 2026년 10월 19일입니다.
Unreal_mcp은(는) 어디에 사용할 수 있나요?
채팅 프롬프트만으로 AI 어시스턴트가 액터를 생성하고, 조명을 배치하고, 레벨을 구성하도록 합니다. Blueprint 이벤트 그래프나 UMG 위젯 레이아웃을 일괄 생성합니다. 어시스턴트가 스크린샷을 찍고 Play-In-Editor 세션을 실행해 에디터 작업 결과를 확인합니다. 팀에서 실행 중인 에디터 하나를 여러 MCP 클라이언트와 공유합니다.
Unreal_mcp는 어떻게 설치하나요?
Releases 페이지에서 v0.6 프리릴리스 플러그인 ZIP을 다운로드합니다 EngineWire 폴더를 프로젝트의 Plugins 디렉터리에 복사합니다: MyGame/Plugins/EngineWire/ Project Settings에서 Enable Native MCP Server를 활성화한 다음 에디터를 다시 시작합니다 capability token을 사용해 Claude Code에 서버를 추가합니다: claude mcp add --transport http unreal-engine http://127.0.0.1:3000/mcp --header "X-MCP-Capability-Token: <token>"
Unreal_mcp은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ChiR24/Unreal_mcp

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트