Unreal Engine MCP Python Bridge 插件

这是一个用于Unreal Engine (UE) 的插件，它创建了模型上下文协议 (MCP)的服务器实现。 这允许像Anthropic的Claude这样的MCP客户端访问完整的UE Python API。

使用场景

• 使用类似Claude的代理在Python中开发工具和工作流程。
• 智能且动态地自动化这些工作流程。
• 与代理进行通用协作开发。

预备条件

• Visual Studio 2019或更高版本（如果从源代码构建）。
• 一个AI代理。下面假设使用Claude。但任何实现了MCP的AI代理都应适用。
• 启用了Python编辑器脚本插件的Unreal Engine 5。
• 注意Unreal Engine Python API。

从Fab安装

最简单的安装MCP Python Bridge插件的方法是从Fab商店列表。购买插件后，它会出现在Epic Games启动器中的库中。点击“安装到引擎”并选择适当的Unreal Engine版本。

从GitHub安装

1. 创建一个新的Unreal Engine C++项目。
2. 在项目根目录下找到Plugins文件夹。
3. 将此仓库克隆到Plugins文件夹中，以便有一个新的包含所有项目内容的文件夹。
4. 右键单击您的UE项目文件（以.uproject结尾），并选择“生成Visual Studio项目文件”。如果您立即看不到该选项，请先选择“显示更多选项”，然后它应该会出现。
5. 打开新的Visual Studio项目并构建。
6. 将MCPClient文件夹中的unreal_mcp_client.py复制到您选择的位置。
7. 查找您的claude_desktop_config.json配置文件。 Mac位置：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows位置：[您的用户账户路径]\AppData\Claude\claude_desktop_config.json
8. 将unreal-engine服务器部分添加到您的配置文件中，并更新路径位置，不包括方括号，如下所示。 Mac路径格式：/[步骤4中的路径]/unreal_mcp_client.py Windows路径格式：C:\\[步骤4中的路径]\\unreal_mcp_client.py

{
  "mcpServers": {
    "unreal-engine": {
      "command": "python",
      "args": [
        "[mac_or_windows_format_path_to_unreal_mcp_client.py]"
      ]
    } 
  }
}

9. 启动Unreal Engine并加载您的新项目。
10. 启用新的UnrealMCPBridge插件，并重新启动。
11. 当您悬停鼠标时，应该有一个新的工具栏按钮显示“启动MCP桥接”。
12. 单击MCP桥接按钮。弹出窗口将显示“MCP Python桥接正在运行”。输出日志将记录一个新的套接字服务器正在监听127.0.0.1:9000。
13. 以管理员身份启动Claude。
14. 单击“从MCP附加”插件图标。在“选择集成”下有两个测试提示：create_castle和create_town。您可以在插件的Content文件夹下的unreal_server_init.py中编辑它们的实现。确保在更改后重新启动Unreal Engine。
15. 或者，让Claude使用UE Python API在您的项目中构建。
16. 通过单击插件图标左侧的锤子图标，可以找到当前已实现的工具列表。

开发新工具和提示

查看unreal_mcp_client.py，您会看到MCP如何使用函数上方的Python装饰器定义工具和提示。例如：

@mcp.tool()
def get_project_dir() -> str:
    """获取顶级项目目录"""
    result = send_command("get_project_dir")
    if result.get("status") == "success":
        response = result.get("result")
        return response
    else:
        return json.dumps(result)

这将get_project_dir命令发送给Unreal Engine执行，并返回当前项目的顶级目录。在插件的Content文件夹下，您可以看到此工具命令的服务器端实现：

@staticmethod
def get_project_dir():
    """获取顶级项目目录"""
    try:
        project_dir = unreal.Paths.project_dir()
        return json.dumps({
            "status": "success",
            "result" : f"{project_dir}"
        })
    except Exception as e:
        return json.dumps({ "status": "error", "message": str(e) })

遵循这个模式，在Claude桌面界面的锤子图标下创建新的工具。

实现新的提示就是将其添加到unreal_mcp_client.py中。例如，这里是来自unreal_mcp_client.py的create_castle提示：

@mcp.prompt()
def create_castle() -> str:
    """创建一座城堡"""
    return f"""
请在当前的Unreal Engine项目中创建一座城堡。
0. 创建新Python代码时，请参考Unreal Engine Python API：https://dev.epicgames.com/documentation/en-us/unreal-engine/python-api/?application_version=5.5
1. 清除场景中的所有静态网格物体。
2. 获取项目目录和内容目录。
3. 寻找可用于构建结构的基本形状。
4. 使用这些基本形状创建一座城堡。
"""

确保保持三重引号，以便整个提示被返回。迭代创建提示的一个好方法是简单地与Claude迭代每个步骤编号，直到获得满意的结果。然后将它们全部合并成一个编号的逐步提示，如上所示。

您必须重启Claude才能使对unreal_mcp_client.py所做的更改生效。请注意，在Windows上，您可能需要在任务管理器中结束Claude进程才能真正重启Claude。