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"
)
실행 모드
방법 | 설명 |
모드_실행_파일 | Python 파일 실행 |
모드 실행문 | Python 명령문 실행 |
모드 평가문 | Python 표현식 평가 |
문제 해결
일반적인 문제:
노드가 발견되지 않았습니다. MCP 플러그인을 사용하여 Unreal 인스턴스가 실행 중인지 확인하세요.
실행 시간 초과: 멀티캐스트 트래픽에 대한 방화벽 설정을 확인하세요.
연결이 끊어짐: 노드 상태 변경 사항을 확인하려면
mcp_unreal.log모니터링하세요.
특허
Apache-2.0 라이선스