chongdashu/unreal-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Cursor, Windsurf, Claude Desktop 같은 AI 어시스턴트 클라이언트가 모델 컨텍스트 프로토콜(MCP)을 사용하여 자연어를 통해 언리얼 엔진을 제어할 수 있도록 지원합니다.
개요
이 프로젝트는 Cursor, Windsurf, Claude Desktop 같은 AI 어시스턴트 클라이언트가 모델 컨텍스트 프로토콜(MCP)을 사용하여 자연어를 통해 언리얼 엔진을 제어할 수 있도록 합니다. 이 프로젝트는 현재 진행 중인 상태입니다. API, 기능, 구현 세부사항은 중대한 변경이 있을 수 있습니다. 테스트와 피드백을 권장하지만, 다음 사항을 유의해 주시기 바랍니다: - 예고 없이 발생하는 변경 사항이 발생할 수 있음 - 기능이 불완전하거나 불안정할 수 있음 - 문서가 오래되었거나 누락되었을 수 있음 - 현재로서는 운영 환경에서의 사용을 권장하지 않습니다 언리얼 MCP 통합은 자연어를 통해 언리얼 엔진을 제어할 수 있는 포괄적인 도구를 제공합니다: 이 모든 기능은 AI 어시스턴트를 통해 자연어 명령어로 접근할 수 있어, 언리얼 엔진 워크플로우를 자동화하고 제어하기 쉽습니다. - Blank 프로젝트를 기반으로 하지만 UnrealMCP 플러그인이 추가되었습니다.
개요(AI 번역)
언리얼-MCP
이 프로젝트는 Cursor, Windsurf, Claude Desktop 같은 AI 어시스턴트 클라이언트가 모델 컨텍스트 프로토콜(MCP)을 사용하여 자연어를 통해 언리얼 엔진을 제어할 수 있도록 합니다.
⚠️ 실험 상태
이 프로젝트는 현재 실험 중 상태입니다. API, 기능, 구현 세부사항은 상당한 변경이 있을 수 있습니다. 테스트와 피드백을 권장하지만, 다음 사항을 유의해 주시기 바랍니다:
- 예고 없이 발생하는 변경 사항
- 특징이 불완전하거나 불안정할 수 있습니다
- 문서가 오래되었거나 누락되었을 수 있습니다
- 현재 생산 사용은 권장되지 않습니다
🌟 개요
언리얼 MCP 통합은 자연어를 통해 언리얼 엔진을 제어할 수 있는 포괄적인 도구를 제공합니다:
| 카테고리 | 역량 |
|---|---|
| 액터 관리 | • 액터(큐브, 구, 조명, 카메라 등) 생성 및 삭제 • 액터 변환 설정(위치, 회전, 스케일) • 액터 속성 조회 및 이름으로 액터 찾기 • 현재 레벨의 모든 액터 목록 |
| 블루프린 개발 | • 커스텀 컴포넌트를 이용한 새로운 블루프린트 클래스 생성 • 컴포넌트(메쉬, 카메라, 조명 등)를 추가하고 구성 |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
This project enables AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
⚠️ Experimental Status
This project is currently in an EXPERIMENTAL state. The API, functionality, and implementation details are subject to significant changes. While we encourage testing and feedback, please be aware that:
- Breaking changes may occur without notice
- Features may be incomplete or unstable
- Documentation may be outdated or missing
- Production use is not recommended at this time
🌟 Overview
The Unreal MCP integration provides comprehensive tools for controlling Unreal Engine through natural language:
| Category | Capabilities |
|---|---|
| Actor Management | • Create and delete actors (cubes, spheres, lights, cameras, etc.)• Set actor transforms (position, rotation, scale)• Query actor properties and find actors by name• List all actors in the current level |
| Blueprint Development | • Create new Blueprint classes with custom components• Add and configure components (mesh, camera, light, etc.)• Set component properties and physics settings• Compile Blueprints and spawn Blueprint actors• Create input mappings for player controls |
| Blueprint Node Graph | • Add event nodes (BeginPlay, Tick, etc.)• Create function call nodes and connect them• Add variables with custom types and default values• Create component and self references• Find and manage nodes in the graph |
| Editor Control | • Focus viewport on specific actors or locations• Control viewport camera orientation and distance |
All these capabilities are accessible through natural language commands via AI assistants, making it easy to automate and control Unreal Engine workflows.
🧩 Components
Sample Project (MCPGameProject) MCPGameProject
- Based off the Blank Project, but with the UnrealMCP plugin added.
Plugin (UnrealMCP) MCPGameProject/Plugins/UnrealMCP
- Native TCP server for MCP communication
- Integrates with Unreal Editor subsystems
- Implements actor manipulation tools
- Handles command execution and response handling
Python MCP Server Python/unreal_mcp_server.py
- Implemented in
unreal_mcp_server.py - Manages TCP socket connections to the C++ plugin (port 55557)
- Handles command serialization and response parsing
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"unrealMCP": {
"command": "uv",
"args": [
"--directory",
"<path/to/the/folder/PYTHON>",
"run",
"unreal_mcp_server.py"
]
}
}
}