kvick-games/unrealmcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

613 stars 80 forks 품질 49 트렌드 21

Repository Install

AI 에이전트가 언리얼을 제어할 수 있도록 MCP를 제공합니다

개요

[discord-shield]: https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord&logoColor=white [discord-url]: https://discord.gg/ThkpVxdzet 지금은 더 많은 도구를 추가하고 코드베이스를 정리하는 작업을 하고 있는데, 메인 플러그인 외부에서 쉽게 도구 확장이 가능할 계획입니다 이 작업은 아직 진행 중이고, 정리해야 할 부분이 많습니다!!!! 또한 저는 윈도우만 사용하기 때문에 Mac/Unix에서 어떻게 설정해야 할지 잘 모릅니다 UnrealMCP는 AI 도구로 Unreal Engine을 제어하기 위해 설계된 비공식 Unreal Engine 플러그인입니다. Unreal Engine 내에 Machine Control Protocol(MCP)을 구현하여 외부 AI 시스템이 Unreal 환경과 프로그래밍적으로 상호작용하고 조작할 수 있도록 합니다. 며칠 전에 MCP를 처음 배워서 익숙하지 않고, 아직 배우는 중이라 처음에는 꽤 어려울 수 있습니다. 저는 https://github.com/ahujasid/blender-mcp를 참고 자료로 구현했는데, 데스크톱용 클로드를 기반으로 합니다.

개요(AI 번역)

아주 진행 중인 리포

지금은 더 많은 도구를 추가하고 코드베이스를 정리하는 작업을 하고 있습니다.
메인 플러그인 외부에서 쉽게 도구 확장이 가능하도록 할 계획입니다

이 작업은 아직 진행 중이고, 정리해야 할 부분이 많습니다!!!

또한 저는 윈도우만 사용하기 때문에 Mac/Unix에서 어떻게 설정해야 할지 잘 모릅니다

개요

UnrealMCP는 AI 도구로 Unreal Engine을 제어하기 위해 설계된 비공식 Unreal Engine 플러그인입니다. Unreal Engine 내에 Machine Control Protocol(MCP)을 구현하여 외부 AI 시스템이 Unreal 환경과 프로그래밍적으로 상호작용하고 조작할 수 있도록 합니다.

며칠 전에야 MCP를 알게 돼서 익숙하지 않고, 아직 배우는 중이라 처음에는 꽤 힘들 수도 있어요. 저는 https://github.com/ahujasid/blender-mcp를 참고 자료로 구현했는데, 데스크톱용 클로드를 기반으로 합니다. 다른 모델에서 작동할지 아닐지는 모르겠지만, 실험해보신다면 꼭 알려주세요!

⚠️ 면책 조항

이 플러그인은 AI 에이전트가 언리얼 엔진 프로젝트를 직접 수정할 수 있게 해줍니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

UnrealMCP Plugin

VERY WIP REPO

I’m working on adding more tools now and cleaning up the codebase, I plan to allow for easy tool extension outside the main plugin

This is very much a work in progress, and I need to clean up a lot of stuff!!!

Also, I only use windows, so I don’t know how this would be setup for mac/unix

Overview

UnrealMCP is an Unofficial Unreal Engine plugin designed to control Unreal Engine with AI tools. It implements a Machine Control Protocol (MCP) within Unreal Engine, allowing external AI systems to interact with and manipulate the Unreal environment programmatically.

I only just learned about MCP a few days ago, so I’m not that familiar with it, I’m still learning so things might be initially pretty rough. I’ve implemented this using https://github.com/ahujasid/blender-mcp as a reference, which relies on claude for desktop. It may or may not work with other models, if you experiment with any, please let me know!

⚠️ DISCLAIMER

This plugin allows AI agents to directly modify your Unreal Engine project. While it can be a powerful tool, it also comes with risks:

AI agents may make unexpected changes to your project
Files could be accidentally deleted or modified
Project settings could be altered
Assets could be overwritten

IMPORTANT SAFETY MEASURES:

Always use source control (like Git or Perforce) with your project
Make regular backups of your project
Test the plugin in a separate project first
Review changes before committing them

By using this plugin, you acknowledge that:

You are solely responsible for any changes made to your project
The plugin author is not responsible for any damage, data loss, or issues caused by AI agents
You use this plugin at your own risk

Features

TCP server implementation for remote control of Unreal Engine
JSON-based command protocol for AI tools integration
Editor UI integration for easy access to MCP functionality
Comprehensive scene manipulation capabilities
Python companion scripts for client-side interaction

Roadmap

These are what I have in mind for development as of 3/14/2025 I’m not sure what’s possible yet, in theory anything, but it depends on how good the integrated LLM is at utilizing these tools.

[X] Basic operations working
[X] Python working
[X] Materials
[ ] User Extensions (in progress)
[ ] Asset tools
[ ] Blueprints
[ ] Niagara VFX
[ ] Metasound
[ ] Landscape (I might hold off on this because Epic has mentioned they are going to be updating the landscape tools)
[ ] Modeling Tools
[ ] PCG

Requirements

Unreal Engine 5.5 (I have only tested on this version, may work with earlier, but no official support)
C++ development environment configured for Unreal Engine

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
    "mcpServers": {
        "unreal": {
            "command": "C:\\UnrealMCP_Project\\Plugins\\UnrealMCP\\MCP\\run_unreal_mcp.bat",
            "args": []
        }
    }
}