虚幻-mcp

Name: 虚幻-mcp
Author: runreal

作者：runreal56 星标更新：2025-06-07

安装使用来源：spider==github.com

项目介绍

unreal-mcp

使用Unreal Python远程执行协议的Unreal Engine MCP服务器

hero

gif

<p align="center"> <a href="https://x.com/runreal_dev">Twitter</a> · <a href="https://discord.gg/6ZhWVU5W47">Discord</a> </p> <div align="center"> <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/LICENSE-MIT-GREEN?style=flat-square"></a> </div>

⚡ 特点

此服务器不需要安装新的UE插件，因为它使用内置的Python远程执行协议。

添加新工具或功能的速度更快，因为不需要任何C++代码。

它可以支持完整的Unreal Engine Python API

⚠️ 注意事项

这不是一个官方的Unreal Engine项目。
您的AI代理或工具将拥有对您的编辑器的完全访问权限。
在批准之前，请审查客户端建议的任何更改。

📦 安装

📋 要求

🔧 Unreal Engine 5.4+（已验证，可能适用于早期版本）
🟢 Node.js 和 npx
🤖 MCP客户端（Claude、Cursor等）

设置您的编辑器：
- 打开您的Unreal Engine项目
- 前往 编辑 -> 插件
- 搜索“Python Editor Script插件”并启用它
- 如果提示，请重新启动编辑器
- 前往 编辑 -> 项目设置
- 搜索“Python”，并启用“启用远程执行”选项

启用插件启用远程执行

设置您的客户端：
- 编辑您的Claude（或Cursor）配置

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": [
        "-y",
        "@runreal/unreal-mcp"
      ]
    }
  }
}

🔧 故障排除

如果您遇到类似于MCP Unreal: Unexpected token 'C', Connection...的错误，这意味着mcp-server无法连接到Unreal Editor。

确保已启用Python Editor Script插件，并且在项目设置中启用了远程执行选项。
尝试将绑定地址从127.0.0.1更改为0.0.0.0，但请注意这将允许本地网络中的连接。
完全重启您的Unreal Editor。
完全关闭/打开您的客户端（Claude、Cursor等），以确保它重新连接到MCP服务器。（Windows上的文件 -> 退出）。
检查正在运行的进程并终止任何僵尸的unreal-mcp Node.js进程。

🛠️ 可用工具

工具	描述
`set_unreal_engine_path`	设置Unreal Engine路径
`set_unreal_project_path`	设置项目路径
`get_unreal_engine_path`	获取当前Unreal Engine路径
`get_unreal_project_path`	获取当前Unreal项目路径
`editor_run_python`	在Unreal Editor内执行任何Python
`editor_list_assets`	列出所有Unreal资产
`editor_export_asset`	导出Unreal资产为文本
`editor_get_asset_info`	获取关于资产的信息，包括StaticMesh和SkeletalMesh资产的LOD级别
`editor_get_asset_references`	获取资产的引用
`editor_console_command`	在Unreal中运行控制台命令
`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`	拍摄Unreal Editor的屏幕截图
`editor_move_camera`	将视口相机移动到特定位置和旋转，用于定位屏幕截图

🤝 贡献

请随时提出问题或拉取请求。欢迎贡献，特别是新的工具/命令。