AI导哈

游戏控制协议服务

X4MCP是一个为X4: Foundations游戏设计的模型上下文协议（MCP）服务器，允许AI助手和外部工具通过HTTP控制运行中的游戏实例。

  • by eg3r
  • C++
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 eg3r/X4Mcp

使用说明

X4Mcp

A. 模型上下文协议 （MCP）服务器 X4：基础 --让AI助手和外部工具通过HTTP控制正在运行的游戏实例。

X4MCP在游戏进程中作为 X4本地 扩展，通过标准MCP接口公开游戏操作。连接您的LLM或任何兼容MCP的客户端，并与您的游戏交互：加载保存、运行命令、查询游戏状态等。

先决条件

  • X4本地 --必须先安装（X4Mcp是X4Native扩展）
  • X4：基础
  • 受保护的UI模式 关闭 在游戏设置中

安装

  1. 从下载最新版本 发布
  2. 提取到您的X4中 extensions/ 文件夹（例如。 X4 Foundations/extensions/x4mcp/)
  3. 启动游戏——MCP服务器自动启动 127.0.0.1:7779

配置

编辑 x4mcp_config.json 在扩展文件夹中更改服务器绑定地址或端口：

{
  "port": 7779,
  "bind_address": "127.0.0.1"
}

可用工具

连接后，MCP客户端可以调用以下工具：

工具 说明
is_game_loaded 检查当前是否加载了保存名
load_game 按文件名、显示名称或 "latest"
shutdown_game 退出X4应用程序
execute_chat_command 运行调试/聊天命令（例如。 thereshallbelight)
list_saves 列出可用的保存名（最多20个最新保存名）
stash_get 检索持久键值对（存活 /reloadui)（X4本地藏匿处）
stash_set 存储持久键值对（X4Native存储）
stash_delete 删除持久键值对（X4Native存储）
log 编写一条具有可配置级别和文件名的日志消息
capture_screenshot 通过X4的原生引擎截图捕获正在运行的游戏，并返回写入的PNG的绝对路径。将游戏窗口带到前景，以便场景渲染（全屏工作），并将X4的圆形阿尔法小插曲平铺为不透明图像——读取返回的路径以查看渲染的帧

从源头构建

需求

  • CMake支持的任何C++编译器工具链
  • CMake 3.20+

构建和部署

.\scripts\build_deploy.ps1            # Debug build + deploy to game
.\scripts\build_deploy.ps1 -Release   # Release build + deploy
.\scripts\build_deploy.ps1 -Clean     # Clean rebuild

或手动：

cmake -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Release
cmake --build build --config Release --target deploy

部署目标会自动从Steam注册表中检测您的X4安装。通过 -DX4_GAME_DIR=<path> 如果自动检测失败。

贡献

欢迎投稿！分叉仓库，创建一个功能分支，并打开一个pull请求。

  1. 分叉并克隆存储库
  2. 创建分支(git checkout -b my-feature)
  3. 在本地构建和测试 .\scripts\build_deploy.ps1
  4. 提交您的更改并打开PR main

许可证

麻省理工学院——见 许可证.

相关 MCP