Unrealmcpbridge

這是一個Unreal Engine插件，實現了Model Context Protocol (MCP)服務端，允許MCP客戶端(如Claude)通過Python API訪問Unreal Engine的全部功能。

開發者工具遊戲與遊戲化 #UE插件 #MCP協議 #Python橋接 #AI協作 .cpp

評分 : 2.5分

下載量 : 6.9K

更新時間 : 2025-04-28

打開站點

What is the MCP Python Bridge?

This plugin implements the Model Context Protocol (MCP) server in Unreal Engine, allowing AI agents to access and control UE through Python scripts. It bridges between Claude (or other MCP-compatible AI) and Unreal Engine's Python API.

How does it work?

The plugin creates a local server that listens for commands from the AI agent. When you run a prompt in Claude, it sends Python commands through MCP which are executed in Unreal Engine.

Use Cases

Ideal for automating repetitive tasks, generating content procedurally, or getting AI assistance with Unreal Engine development workflows.

Key Features

Full UE Python API Access

Provides complete access to Unreal Engine's Python API through MCP protocol

Prebuilt Prompts

Includes ready-to-use prompts like 'create_castle' that demonstrate common automation tasks

Custom Tool Development

Easily create new tools and prompts that appear in Claude's interface

Advantages

Enables AI-assisted Unreal Engine development

Reduces repetitive manual work through automation

Extensible through custom Python tools and prompts

Works with any MCP-compatible AI agent

Limitations

Requires basic Python knowledge for advanced customization

Need to restart Claude after modifying tools

Windows users may need to manually kill Claude process

Getting Started

Install the Plugin

Install from Fab store or clone from GitHub into your project's Plugins folder

Configure Claude

Add the MCP server configuration to claude_desktop_config.json with path to unreal_mcp_client.py

Enable and Start

Enable the plugin in UE Editor and click 'Start MCP Bridge' button

Connect Claude

In Claude desktop app, click 'Attach from MCP' plug icon and select integration

Example Use Cases

Scene Generation

Automatically generate complete scenes using basic shapes

Asset Processing

Batch process assets in Content Browser

Frequently Asked Questions

Do I need to know Python to use this?

Why isn't Claude recognizing my new tools?

Can I use other AI agents besides Claude?

Additional Resources

Model Context Protocol Documentation

Official MCP protocol specifications

Unreal Engine Python API

Reference for available Python commands

Plugin GitHub Repository

Source code and issue tracking

🚀 虛幻引擎 MCP Python 橋接插件

這是一款專為虛幻引擎（UE）打造的插件，它實現了 Model Context Protocol (MCP) 的服務器端。藉助該插件，諸如 Anthropic 的 Claude 這類 MCP 客戶端能夠訪問完整的 UE Python API。

🚀 快速開始

使用場景

藉助工具和工作流在 Python 中開展開發工作，並利用類似 Claude 的智能體實現自動化操作。
達成工作流的智能與動態自動化。
與智能體協同進行通用協作式開發。

先決條件

若從代碼構建，需安裝 Visual Studio 2019 或更高版本。
準備一個 AI 智能體，以下示例以 Claude 為例，但任何實現 MCP 的 AI 智能體均可使用。
安裝啟用 Python 編輯器腳本插件的虛幻引擎 5。
留意虛幻引擎 Python API。

📦 安裝指南

從 Fab 安裝

最為便捷的安裝方式是從 Fab 商店頁面安裝 MCP Python 橋接插件。購買完成後，插件會出現在 Epic Games 啟動器的庫中。點擊“安裝到虛幻引擎”，然後依照提示完成安裝流程。

從 GitHub 安裝

若無法通過 Fab 進行安裝，可從 GitHub 下載源代碼並手動構建：

訪問 GitHub 倉庫。
將倉庫克隆至本地開發環境。
打開 Visual Studio 2019 或更高版本，接著打開項目文件夾中的 .uproject 文件。
點擊“構建”以生成插件。

💻 使用示例

基礎用法

要在 unreal_mcp_client.py 中添加新的工具和提示，只需遵循現有的模式。例如，以下是如何在客戶端中定義一個名為 create_castle() 的新提示：

@mcp.prompt()
def create_castle() -> str:
    """創建一座城堡"""
    return f"""
請在當前虛幻引擎項目中創建一座城堡。
0. 參考虛幻引擎 Python API 以查找創建新代碼的文檔：https://dev.epicgames.com/documentation/en-us/unreal-engine/python-api/?application_version=5.5
1. 清理場景中的所有 StaticMeshActors。
2. 獲取項目目錄和內容目錄。
3. 找到構建結構的基本形狀。
4. 使用這些基本形狀創建一座城堡。
"""

每次修改 unreal_mcp_client.py 後，必須重啟 Claude 以使更改生效。在 Windows 上，可能需要通過任務管理器結束 Claude 進程才能完全重啟。

通過遵循上述步驟，您可以輕鬆地將新的工具和提示集成到 MCP Python 橋接插件中，並擴展與 Claude 的交互能力。