虚幻的mcp
用于虚幻引擎的MCP服务器，使用虚幻Python远程执行
Twitter · Discord
⚡ 差异
此服务器不需要安装新的UE插件，因为它使用内置的Python远程执行协议。
添加新工具/功能的开发速度要快得多，因为它不需要任何C++代码。
它可以支持全部 虚幻引擎Python API
⚠️ 备注
- 这不是虚幻引擎的官方项目。
- 您的AI代理或工具将可以完全访问您的编辑器。
- 在批准之前，请先查看客户建议的任何更改。
📦 安装
📋 需求
- 🔧 虚幻引擎5.4+（已验证，可能适用于早期版本）
- 🟢 Node.js与npx
- 🤖 MCP客户端（Claude、Cursor等）
- 设置编辑器：
- 打开虚幻引擎项目 - 首选 Edit -> Plugins - 搜索“Python编辑器脚本插件”并启用它 - 如果出现提示，请重新启动编辑器 - 首选 Edit -> Project Settings - 搜索“Python”并启用“启用远程执行”选项
- 设置您的客户：
- 编辑您的Claude（或Cursor）配置
{
"mcpServers": {
"unreal": {
"command": "npx",
"args": [
"-y",
"@runreal/unreal-mcp"
]
}
}
}🔧 故障排除
如果你遇到类似的错误 MCP Unreal: Unexpected token 'C', Connection... 这意味着mcp服务器无法连接到虚幻编辑器。
- 确保启用了Python编辑器脚本插件，并在项目设置中选中了远程执行选项。
- 还可以尝试更改绑定地址
127.0.0.1向0.0.0.0但请注意，这将允许来自本地网络的连接。 - 完全重新启动虚幻编辑器。
- 完全关闭/打开您的客户端（Claude、Cursor等），以确保它重新连接到MCP服务器。 (
File -> Exit在窗户上）。 - 检查你正在运行的进程，并杀死任何僵尸不真实的mcp Node.js进程。
🛠️ 可用工具
| 工具 | 说明 |
|---|---|
set_unreal_engine_path | 设置虚幻引擎路径 |
set_unreal_project_path | 设置项目路径 |
get_unreal_engine_path | 获取当前虚幻引擎路径 |
get_unreal_project_path | 获取当前虚幻项目路径 |
editor_run_python | 在虚幻编辑器中执行任何python |
editor_list_assets | 列出所有虚幻资源 |
editor_export_asset | 将虚幻资源导出为文本 |
editor_get_asset_info | 获取有关资源的信息，包括StaticMesh和Skeleton Mesh资源的LOD级别 |
editor_get_asset_references | 获取资产的参考 |
editor_console_command | 在虚幻中运行控制台命令 |
editor_project_info | 获取当前项目的详细信息 |
editor_get_map_info | 获取当前地图/级别的详细信息 |
editor_search_assets | 使用可选的类过滤器按名称或路径搜索资产 |
editor_get_world_outliner | 获取当前世界中所有演员的财产 |
editor_validate_assets | 验证项目中的资产以检查错误 |
editor_create_object | 在世界中创建一个新对象/参与者 |
editor_update_object | 更新世界中现有的对象/参与者 |
editor_delete_object | 从世界中删除对象/参与者 |
editor_take_screenshot | 截取虚幻编辑器的屏幕截图 |
editor_move_camera | 将视口摄影机移动到特定位置并旋转以定位屏幕截图 |
🤝 贡献
请随时打开问题或撤回请求。欢迎投稿，特别是新的工具/命令。