关键词

游戏开发Unreal EngineAI助手资产管理Python自动化

项目简介

Adastrea Director是一个智能游戏开发助手系统，通过Model Context Protocol (MCP) 为AI客户端提供对Unreal Engine的编程式访问，支持资产操作、Python执行和引擎控制。

主要功能

  • Unreal Engine集成：通过MCP服务器直接控制Unreal Engine编辑器
  • 资产管理系统：列表、搜索、加载、保存Unreal资产
  • Actor操作：生成、查询、删除场景中的Actor对象
  • Python执行环境：在Unreal Editor中运行Python代码
  • 项目信息获取：读取引擎版本、项目设置等元数据
  • 控制台命令执行：在Unreal Engine中执行控制台指令
  • 实时日志捕获：自动记录Unreal Engine输出日志供AI代理处理
  • 多客户端支持：兼容5ire、Cline、Zed等MCP客户端

安装步骤

  1. 克隆仓库：'git clone https://github.com/Mittenzx/Adastrea-Director.git
  2. 运行设置脚本：'./setup.sh'（Linux/Mac）或手动安装依赖
  3. 配置API密钥（Gemini或OpenAI）
  4. 填充游戏数据库以获取完整上下文

服务器配置

MCP服务器可以通过以下方式启动：

{
  "mcp_servers": {
    "adastrea-director": {
      "command": "python",
      "args": ["unreal_mcp_cli.py"]

基本使用方法

  • 交互式模式：'python unreal_mcp_cli.py'
  • 直接命令：
    • 'python unreal_mcp_cli.py project-info' - 获取项目信息
  • 'python unreal_mcp_cli.py list-assets' - 列出所有资产
  • Python执行：'python unreal_mcp_cli.py run-python "import unreal; print(unreal.SystemLibrary.get_engine_version())'
  • 工具调用：支持所有MCP工具的直接执行

连接配置

MCP客户端需要配置连接到该服务器的启动命令和参数，支持Stdio、SSE、WebSocket等多种传输协议。

信息

分类

开发者工具

访问项目