remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Facilitates executing Python code remotely within Unreal Engine instances, supporting multiple execution modes including file execution and statement evaluation.
Enables remote Python code execution in Unreal Engine environments, supporting both attended and unattended execution modes, file execution, and statement evaluation through an automatic node discovery system.

MCP 언리얼 서버

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

특징

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

설치

지엑스피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 라이선스

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

멀티캐스트 네트워크를 통해 자동으로 Unreal 노드를 검색하고 관리하는 기능을 갖춘 Unreal Engine 환경에서 원격 Python 코드 실행을 가능하게 하는 서버 구현입니다.

MCP Unreal Server