MCP 언리얼 서버

원격 Python 실행을 통해 Unreal Engine 인스턴스와 상호작용하기 위한 서버 구현입니다.

특징

🚀 언리얼 인스턴스 관리
- 멀티캐스트를 통한 Unreal 노드 자동 검색
- 실시간 노드 상태 모니터링
- LSP 호환 클라이언트를 통한 리소스 목록
💻 원격 실행
- Unreal Engine 환경에서 Python 코드 실행
- 참석 및 무인 실행 모드 모두 지원
- 파일 실행 및 명령문 평가 모드
📊 로깅 및 모니터링
- 파일에 대한 자세한 로깅( mcp_unreal.log )
- 다양한 자세한 수준을 사용한 콘솔 로깅
- 노드 연결 상태 모니터링

Related MCP server: Unity MCP Integration

설치

지엑스피1

구성

네트워크 설정

RemoteExecutionConfig 에서 멀티캐스트 매개변수를 구성합니다.

# Default multicast settings (modify in server.py)
config.multicast_group_endpoint = ("239.0.0.1", 6766)

벌채 반출

server.py 에서 로깅 구성을 수정합니다:

# Adjust log levels
file_handler.setLevel(logging.DEBUG)  # File logging
console_handler.setLevel(logging.INFO)  # Console logging

용법

서버 시작

python -m src.mcp_server_unreal.server

지원되는 도구

언리얼 인스턴스에 연결

{
  "host": "239.0.0.1",
  "port": 6766
}

파이썬 코드 실행

{
  "node_id": "<unreal-node-id>",
  "code": "print('Hello Unreal')",
  "unattended": true
}

API 문서

리소스 형식

types.Resource(
    uri="unreal://<node_id>",
    name=f"Unreal Instance: {node_id}",
    description="Unreal Engine instance",
    mimeType="application/x-unreal"
)