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

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

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.

Tools

execute-python

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

Related MCP Servers

Blender MCP Server
cwahlfeldt
-
security
F
license
-
quality
A Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.
Last updated -
8
Unity MCP Integration
quazaai
-
security
A
license
-
quality
A server that enables AI assistants to understand and interact with Unity projects in real-time, providing access to scene hierarchy, project settings, and the ability to execute code directly in the Unity Editor.
Last updated -
92
MIT License
nUR MCP Server
nonead
A
security
F
license
A
quality
A Model Context Protocol server that enables natural language interactive control of Universal Robots collaborative robots, allowing users to control robot motion, monitor status, and execute programs through direct commands to large language models.
Last updated -
29
3
Unreal Engine MCP Bridge
gingerol
-
security
A
license
-
quality
A server that enables control of Unreal Engine 5.5+ using natural language commands, allowing users to create Blueprints, manipulate actors, work with nodes, manage project settings, and create UMG widgets through the Model Context Protocol.
Last updated -
1
MIT License

View all related MCP servers

MCP Unreal Server