kvick-games/unrealmcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

613 stars 80 forks Качество 49 Тренд 21

Repository Install

MCP позволят агентам ИИ управлять Unreal

Обзор

[discord-щит]: https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord&logoColor=white [discord-url]: https://discord.gg/ThkpVxdzet Сейчас я работаю над добавлением новых инструментов и очисткой кодовой базы, планирую сделать возможность простого расширения инструментов вне основного плагина Это всё ещё в процессе, и мне нужно многое привести в порядок!!!! Кроме того, я использую только Windows, так что не знаю, как это будет настроено для Mac/Unix UnrealMCP — это неофициальный плагин Unreal Engine, разработанный для управления Unreal Engine с помощью инструментов ИИ. Он реализует Протокол управления машиной (MCP) внутри Unreal Engine, позволяющий внешним системам искусственного интеллекта взаимодействовать с средой Unreal и программно управлять ею. Я только что узнал о MCP всего несколько дней назад, так что не особо знаком с ним, я всё ещё учусь, так что поначалу всё может быть довольно сложно. Я реализовал это, используя https://github.com/ahujasid/blender-mcp в качестве справочника, который для рабочего стола опирается на Claude.

Обзор (машинный перевод)

ОЧЕНЬ WIP REPO

Сейчас я работаю над добавлением новых инструментов и очисткой кодовой базы,
Я планирую позволить удобное расширение инструментов вне основного плагина

Это всё ещё в процессе, и мне нужно многое привести в порядок!!!

Кроме того, я использую только Windows, так что не знаю, как это будет настроено для Mac/Unix

Обзор

UnrealMCP — это неофициальный плагин Unreal Engine, разработанный для управления Unreal Engine с помощью инструментов ИИ. Он реализует Протокол управления машиной (MCP) внутри Unreal Engine, позволяющий внешним системам искусственного интеллекта взаимодействовать с средой Unreal и программно управлять ею.

Я только что узнал о MCP всего несколько дней назад, так что не особо знаком с ним, я всё ещё учусь, так что сначала может быть довольно сложно. Я реализовал это, используя https://github.com/ahujasid/blender-mcp в качестве справочника, который для рабочего стола опирается на Claude. Возможно, это работает с другими моделями, а может и нет, если будете экспериментировать с ними, пожалуйста, дайте знать!

⚠️ ОТКАЗ от ОТВЕТСТВЕННОСТИ

Этот плагин позволяет AI-агентам напрямую изменять ваш проект на Unreal Engine.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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

Открыть полный README на GitHub

Установка

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": []
        }
    }
}