HOI4 Agent Tools

本地服务

github.com游戏娱乐83 天前更新

代码仓库访问官网

关于 HOI4 Agent Tools

HOI4 Agent Tools 是供编码 Agent 构建和编辑《Hearts of Iron IV》模组的 MCP 服务。它提供基于模组源码的预览、文档查询、脚本修复，以及地图创建和 AI 选择平衡工具。

主要功能

01构建国策树、事件与决议
02编辑地图并生成新世界
03预览树、窗口与地图
04查询游戏文档
05分析脚本并调整 AI 选择

适用场景

01为模组创建国策树
02根据参考图生成世界
03查找并修复损坏的脚本
04写入地图前预览效果

MCP 相关

该 MCP 服务向编码 Agent 提供模组编辑、预览、文档查询和脚本分析工具。共享使用时，也可通过带令牌或 OAuth 的 HTTP 提供相同工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "klimpaskov-hoi4-agent-tools": {
      "command": "npx",
      "args": [
        "-y",
        "hoi4-agent-tools"
      ]
    }
  }
}

启动命令npx -y hoi4-agent-tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmhoi4-agent-tools4.6.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

HOI4 Agent Tools

一个 MCP 服务，可帮助编码 Agent 构建和编辑《钢铁雄心 IV》模组。制作国策树、事件和决议。编辑地图并生成新世界。预览窗口、树和地图，在文档中查找正确规则，修复损坏的脚本并调整 AI 选择。

功能

你的 Agent 可以构建和编辑国策树、事件、决议和地图，还能生成新世界。

要创建新地图，请提供一张经过清理的本地参考图，并在写入前预览解析出的地理信息。地图工作流会创建省份、州、地形、城市、国家、补给和临时开局场景。经过审核的名称和遮罩可帮助完善模糊的图稿；离线验证与原生战役验收相互独立。它可以预览国策树、科技文件夹、窗口和地图，在游戏文档中查找正确规则，修复损坏的脚本并调整 AI 选择。你只需描述想要什么；Agent 会选择合适的工具。

快速开始

安装 Node.js 22（22.19 或更高版本）或 24，并保留《钢铁雄心 IV》的安装，以便使用原版文件、图稿和字体。
安装服务：
```
npm install --global hoi4-agent-tools
```
输出客户端配置：
```
hoi4-agent-tools-setup --print-client-config
```
将 globalInstall 配置块粘贴到 Claude Code、Claude Desktop 或 Cursor 等 JSON 客户端，或将 codexTomlGlobal 配置块粘贴到 Codex 的 config.toml 中。
将模组文件夹设为 Agent 的工作区，并告诉它要构建或修复什么。

设置指南介绍如何处理多个模组、指定游戏路径、本地维基快照，以及使用 --discover 和 --diagnose 排查问题。

观看 Agent Tools 演示，或使用 HOI4 Mod Setup 为你的模组安装并连接服务。这是 HOI4 模组工具包的一部分，包含 Agentic HOI4 Modding（面向 Agent 的技能和指令）和 HOI4 Live Tools（在运行中的游戏内测试）。

示例

每组对比都展示了游戏截图，以及服务对同一源文件的预览。

游戏内	服务预览

请参阅示例集了解更多内容。

工具

该服务为你的 Agent 提供预览、文档、脚本分析和编辑工具。 Agent 会将这些工具与文件编辑器结合，用于构建事件和决议、修复脚本以及调整 AI 权重。工具参考列出了集成所需的准确名称、参数和结果。

常见问题

编辑会保存到哪里？ 更改会写入你的模组文件夹；使用 Git 查看或撤销更改。

它会运行游戏吗？ 不会。预览来自模组源文件；请在 HOI4 中测试游戏过程，以查看实际点击、AI 选择和时序。

配置

在模组文件夹中启动时，该服务无需配置文件。当你要处理多个模组，或游戏未被自动找到时，hoi4-agent-tools-setup --init 会写入配置文件。对于远程或共享使用，hoi4-agent-tools-http 可通过令牌或 OAuth，以 HTTP 提供相同的工具。请参阅配置参考和 HTTP 指南。