Unreal Engine MCP Python Bridge Plugin
2025.04.10
4
PythonUnreal Engine插件Python API桥接AI协作开发开发效率
UnrealMCPBridge是一个为Unreal Engine（UE）设计的插件，实现了Model Context Protocol (MCP)的服务器端。该插件允许MCP客户端（如Anthropic的Claude）通过Python API与Unreal Engine进行交互，从而实现智能化的工具开发和动态工作流自动化。
View on GitHub
Overview
基本能力
产品定位
UnrealMCPBridge旨在通过MCP协议桥接Unreal Engine与AI代理（如Claude），实现Python脚本驱动的智能开发工具和工作流自动化。
核心功能
- 实现MCP协议的服务器端，支持与MCP客户端（如Claude）的交互
- 提供Unreal Engine Python API的完整访问能力
- 支持自定义工具和提示的开发与集成
- 动态自动化Unreal Engine项目中的工作流
适用场景
- 使用Python和AI代理（如Claude）开发Unreal Engine工具和工作流
- 智能化和动态化自动化Unreal Engine项目中的任务
- 与AI代理协作进行Unreal Engine开发
工具列表
get_project_dir: 获取当前项目的顶级目录create_castle: 创建一个城堡的提示create_town: 创建一个城镇的提示
常见问题解答
- 需要以管理员权限运行Claude
- 修改
unreal_mcp_client.py后需要重启Claude才能生效 - Windows用户可能需要通过任务管理器结束Claude进程才能完全重启
使用教程
使用依赖
- Unreal Engine 5（需启用Python Editor Script Plugin）
- AI代理（如Claude）
安装教程
- 创建新的Unreal Engine项目
- 在项目根目录下的
Plugins文件夹中克隆此仓库 - 将
unreal_mcp_client.py从'MCPClient'文件夹复制到指定位置 - 修改
claude_desktop_config.json配置文件，添加unreal-engine服务器部分 - 启动Unreal Engine并加载新项目
- 启用
UnrealMCPBridge插件并重启 - 点击工具栏中的"Start MCP Bridge"按钮
- 以管理员权限启动Claude
- 点击"Attach from MCP"插件图标选择集成
调试方式
- 检查Output Log中是否有socket server监听在127.0.0.1:9000
- 使用提供的测试提示（
create_castle和create_town）验证功能 - 通过点击hammer图标查看当前实现的工具列表