X4Mcp
A. 模型上下文协议 （MCP）服务器 X4：基础 --让AI助手和外部工具通过HTTP控制正在运行的游戏实例。
X4MCP在游戏进程中作为 X4本地 扩展，通过标准MCP接口公开游戏操作。连接您的LLM或任何兼容MCP的客户端，并与您的游戏交互：加载保存、运行命令、查询游戏状态等。
______________________________________________________________________
先决条件
- X4本地 --必须先安装（X4Mcp是X4Native扩展）
- X4：基础
- 受保护的UI模式 关闭 在游戏设置中
______________________________________________________________________
安装
- 从下载最新版本 发布
- 提取到您的X4中
extensions/文件夹（例如。X4 Foundations/extensions/x4mcp/) - 启动游戏——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 | 编写一条具有可配置级别和文件名的日志消息 |
______________________________________________________________________
从源头构建
需求
- 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= 如果自动检测失败。
______________________________________________________________________
贡献
欢迎投稿！分叉仓库，创建一个功能分支，并打开一个pull请求。
- 分叉并克隆存储库
- 创建分支(
git checkout -b my-feature) - 在本地构建和测试
.\scripts\build_deploy.ps1 - 提交您的更改并打开PR
main
______________________________________________________________________
许可证
麻省理工学院——见 许可证.