kvick-games/unrealmcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

613 stars 80 forks 品質 49 トレンド 21

Repository Install

AIエージェントがUnrealを制御できるようにするMCPです

概要

[discord-shield]: https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord&logoColor=white [discord-url]: https://discord.gg/ThkpVxdzet 今はツールを追加し、コードベースの整理に取り組んでいます。メインプラグイン以外でも簡単にツール拡張できるようにする予定ですこれはまだ進行中の作業で、片付けるものがたくさんあります!!!! また、私はWindowsしか使わないので、MacやUnixでどう設定するのかもわかりません UnrealMCPは、AIツールを使ってUnreal Engineを制御するために設計された非公式のUnreal Engineプラグインです。Unreal Engine内にMachine Control Protocol(MCP)を実装しており、外部AIシステムがUnreal環境とプログラム的に操作できるようにします。 MCPについて学んだのは数日前なのであまり詳しくなく、まだ学んでいる途中なので最初はかなり難しいかもしれません。私はhttps://github.com/ahujasid/blender-mcpを参考にして実装しましたが、デスクトップにはClaudeを利用しています。

概要（AI 翻訳）

とてもウィップ・レポ

今はツールを追加し、コードベースの整理に取り組んでいます。メインプラグイン以外で簡単にツール拡張できるようにするつもりです

これはまだ進行中の作業で、片付けるものがたくさんあります!!!

また、私はWindowsしか使わないので、MacやUnixでどう設定するのかもわかりません

概要

UnrealMCPは、AIツールを使ってUnreal Engineを制御するために設計された非公式のUnreal Engineプラグインです。Unreal Engine内にMachine Control Protocol(MCP)を実装しており、外部AIシステムがUnreal環境とプログラム的に操作できるようにします。

MCPについて知ったのは数日前なのであまり詳しくなく、まだ学んでいる途中なので最初はかなり大変かもしれません。私はhttps://github.com/ahujasid/blender-mcpを参考にして実装しましたが、デスクトップ版はClaudeを利用しています。他のモデルで動作するかどうかは分かりませんが、もし試してみたらぜひ教えてください!

⚠️ 免責事項

このプラグインはAIエージェントがUnreal Engineのプロジェクトを直接変更できるようにします。

このページは 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": []
        }
    }
}