Unreal Blueprint MCP Server

Description

언리얼 엔진 블루프린트 조작을 위한 MCP (Model Context Protocol) 서버입니다. FastMCP를 기반으로 구현되었으며, 기존 언리얼 엔진 플러그인과 WebSocket을 통해 통신합니다.

Features

블루프린트 생성 및 편집
블루프린트 속성 설정
블루프린트 컴파일
블루프린트 노드 추가
연결 상태 모니터링
JSON-RPC 2.0 표준 준수

Build Instructions

Prerequisites

Python 3.10 이상
pip 패키지 관리자

Installation

# 1. 의존성 설치 cd server pip install -r requirements.txt # 2. 서버 실행 fastmcp run unreal_blueprint_mcp_server.py

Alternative Method

# Python 모듈로 실행 python -m fastmcp run server/unreal_blueprint_mcp_server.py

Usage

MCP 클라이언트에서 사용

# 블루프린트 생성 result = await client.call_tool("create_blueprint", { "blueprint_name": "MyActor", "parent_class": "Actor", "asset_path": "/Game/Blueprints/" }) # 서버 상태 확인 status = await client.call_tool("get_server_status", {})

WebSocket 연결

개발 모드: ws://localhost:8000/ws (fastmcp dev)
운영 모드: ws://localhost:8001/ws (fastmcp run)
프로토콜: JSON-RPC 2.0
기존 언리얼 플러그인과 호환

Dependencies

fastmcp: MCP 서버 프레임워크
pydantic: 데이터 검증 및 시리얼라이제이션
starlette: WebSocket 지원
uvicorn: ASGI 서버

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables AI agents to create and modify Unreal Engine blueprints using natural language commands. Supports blueprint creation, property modification, and real-time communication with Unreal Editor through WebSocket integration.

UnrealBlueprintMCP