README.md•1.55 kB
# Unreal Blueprint MCP Server
## Description
언리얼 엔진 블루프린트 조작을 위한 MCP (Model Context Protocol) 서버입니다. FastMCP를 기반으로 구현되었으며, 기존 언리얼 엔진 플러그인과 WebSocket을 통해 통신합니다.
## Features
- 블루프린트 생성 및 편집
- 블루프린트 속성 설정
- 블루프린트 컴파일
- 블루프린트 노드 추가
- 연결 상태 모니터링
- JSON-RPC 2.0 표준 준수
## Build Instructions
### Prerequisites
- Python 3.10 이상
- pip 패키지 관리자
### Installation
```bash
# 1. 의존성 설치
cd server
pip install -r requirements.txt
# 2. 서버 실행
fastmcp run unreal_blueprint_mcp_server.py
```
### Alternative Method
```bash
# Python 모듈로 실행
python -m fastmcp run server/unreal_blueprint_mcp_server.py
```
## Usage
### MCP 클라이언트에서 사용
```python
# 블루프린트 생성
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 서버