关键词

文明5 AI游戏AI后端策略游戏LLM集成游戏上下文

项目简介

Vox Deorum MCP 服务器是大型语言模型 (LLM) 增强型AI系统 Vox Deorum 的核心后端组件，专为《文明5》游戏设计。它将游戏内部的复杂状态抽象为标准化的资源和工具，供LLM驱动的AI客户端查询和操作，从而实现对游戏AI行为的智能控制。

主要功能点

  • 游戏状态暴露： 将《文明5》的游戏状态（如科技、政策、建筑、单位、文明信息、事件、玩家数据、城市信息等）结构化为可查询的资源。
  • 游戏操作工具： 提供一系列工具，允许LLM客户端执行游戏内动作，例如设置玩家策略、调整AI个性、暂停/恢复游戏等。
  • 实时事件流： 通过Server-Sent Events (SSE) 接收游戏事件，并可将关键事件通知给LLM客户端。
  • 多传输协议支持： 支持标准输入/输出 (Stdio) 和 HTTP/HTTPS 传输协议进行客户端通信。
  • 数据库集成： 深度集成《文明5》游戏数据库，支持查询详细的游戏百科信息和进行文本本地化。

安装步骤

  1. 克隆仓库： 首先，使用 Git 命令克隆整个 'vox-deorum' 仓库，并确保同时克隆其子模块： 
    git clone --recursive https://github.com/CIVITAS-John/vox-deorum.git
cd vox-deorum
  2. 安装依赖： 在仓库根目录下，运行以下命令安装所有工作区的项目依赖： 
    npm install --workspaces
  3. 构建 DLL (可选)： 如果您需要自定义游戏 DLL，可以运行 'scripts\update-dlls.cmd'。通常情况下，仓库已包含预构建的二进制文件，此步骤不是必需的。
  4. 启动 Bridge 服务： MCP 服务器依赖于 'bridge-service' 组件来与《文明5》游戏进行通信。请在 'vox-deorum' 根目录下，进入 'bridge-service' 目录并启动它： 
    cd bridge-service
npm start
    重要提示： 请确保《文明5》游戏已运行，并且您已加载了社区补丁 Mod。Bridge 服务需要游戏运行才能成功连接。
  5. 启动 MCP 服务器： 在 Bridge 服务启动后，回到 'vox-deorum' 根目录，进入 'mcp-server' 目录并启动 MCP 服务器： 
    cd mcp-server
npm start
    MCP 服务器默认会通过 HTTP 协议在 'http://127.0.0.1:4000/mcp' 地址监听来自 MCP 客户端的请求。

MCP 客户端配置

您的 MCP 客户端需要以下配置信息才能与 Vox Deorum MCP 服务器建立连接。请根据您的实际环境调整 'command' 和 'args' 中的路径。

HTTP 传输协议配置示例：

  • 服务器名称： vox-deorum-mcp-server
  • 启动命令： node
  • 命令参数： '["path/to/vox-deorum/mcp-server/dist/index.js"]' (请将 'path/to/vox-deorum' 替换为您的实际仓库路径)
  • 环境变量：
    • 'MCP_TRANSPORT': http (指定使用 HTTP 传输协议)
    • 'MCP_PORT': 4000 (服务器监听的端口)
    • 'MCP_HOST': 127.0.0.1 (服务器监听的主机地址)
    • 'BRIDGE_SERVICE_URL': http://127.0.0.1:5000 (Bridge 服务的 URL，MCP 服务器通过它与游戏通信)
    • 'LOG_LEVEL': info (服务器日志级别，可选 debug/warn/error)
  • 描述： 连接到为文明5 AI 提供游戏上下文的 Vox Deorum MCP 服务器。

Stdio 传输协议配置示例：

  • 服务器名称： vox-deorum-mcp-server
  • 启动命令： node
  • 命令参数： '["path/to/vox-deorum/mcp-server/dist/index.js"]' (请将 'path/to/vox-deorum' 替换为您的实际仓库路径)
  • 环境变量：
    • 'MCP_TRANSPORT': stdio (指定使用标准输入/输出传输协议)
    • 'BRIDGE_SERVICE_URL': http://127.0.0.1:5000 (Bridge 服务的 URL，MCP 服务器通过它与游戏通信)
    • 'LOG_LEVEL': info (服务器日志级别，可选 debug/warn/error)
  • 描述： 连接到为文明5 AI 提供游戏上下文的 Vox Deorum MCP 服务器。

基本使用方法

  1. 确保您的《文明5》游戏已运行，并且已加载社区补丁 Mod。
  2. 按照上述“安装步骤”中的说明，依次启动 'bridge-service' 和 'mcp-server'。
  3. 您的 LLM 客户端（例如 'vox-deorum' 项目中的 'vox-agents' 组件或其他任何兼容 MCP 协议的客户端）可以使用上文提供的配置信息连接到 MCP 服务器。
  4. 连接成功后，LLM 客户端即可通过调用 MCP 服务器暴露的工具（例如 'get-players' 获取游戏中的玩家信息，'set-strategy' 调整 AI 的游戏策略）来实时驱动和控制《文明5》游戏中的 AI 行为。

信息

分类

AI与计算

访问项目