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

지원되는 도구

1. 언리얼 인스턴스에 연결

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

2. 파이썬 코드 실행

{
  "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"
)

실행 모드

문제 해결

일반적인 문제:

• 노드가 발견되지 않았습니다. MCP 플러그인을 사용하여 Unreal 인스턴스가 실행 중인지 확인하세요.

• 실행 시간 초과: 멀티캐스트 트래픽에 대한 방화벽 설정을 확인하세요.

• 연결이 끊어짐: 노드 상태 변경 사항을 확인하려면 mcp_unreal.log 모니터링하세요.

특허

Apache-2.0 라이선스