mcpField
H
HOI4 Agent Tools

HOI4 Agent Tools

ローカル
github.comゲーム・エンタメ83 日前に更新
リポジトリ公式サイト

HOI4 Agent Tools について

HOI4 Agent Toolsは、Hearts of Iron IVのMODを作成・編集するコーディングエージェント向けMCPサーバーです。MODソースのプレビュー、ドキュメント検索、スクリプト修正に加え、マップ作成やAIの選択調整を支援します。

主な機能

  1. 01国家方針ツリー、イベント、決議の作成
  2. 02マップ編集と新世界の生成
  3. 03ツリー、ウィンドウ、マップのプレビュー
  4. 04ゲームドキュメントの検索
  5. 05スクリプト分析とAI選択の調整

活用シーン

  1. 01MOD用の国家方針ツリー作成
  2. 02参照画像からのワールド生成
  3. 03壊れたスクリプトの発見と修正
  4. 04マップ書き込み前のプレビュー

MCP 対応

MCPサーバーは、コーディングエージェントにMOD編集、プレビュー、ドキュメント検索、スクリプト分析のツールを提供します。共有利用では、トークンまたは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.1

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

HOI4 Agent Tools

HOI4 Agent Tools のデモを見る

npm Node.js ライセンス Discord YouTube Ko-fi ダウンロード 問題

コーディングエージェントによるHearts of Iron IVのMODの作成と編集を支援するMCPサーバーです。 国家方針ツリー、イベント、ディシジョンを作成できます。マップを編集して、新しい世界を生成できます。ウィンドウ、ツリー、マップをプレビューしたり、ドキュメントから適切なルールを探したり、壊れたスクリプトを修正したり、AIの選択を調整したりできます。

できること

エージェントは、国家方針ツリー、イベント、ディシジョン、マップを作成・編集し、新しい世界を生成できます。

新しいマップを作るときは、不要な要素を取り除いたローカルの参照画像を渡し、解釈された地形をプレビューしてから書き込みます。マップのワークフローでは、プロヴィンス、ステート、地形、都市、国家、補給、暫定的な初期シナリオを作成します。確認済みの地名とマスクで曖昧な画像を調整できます。オフライン検証はゲーム本編でのキャンペーン受け入れテストとは別に行います。 国家方針ツリー、技術フォルダー、ウィンドウ、マップをプレビューし、ゲームのドキュメントから適切なルールを探し、壊れたスクリプトを修正してAIの選択を調整します。 作りたいものを説明すれば、エージェントが適切なツールを選びます。

クイックスタート

  1. Node.js 22（22.19以降）または24をインストールし、バニラのファイル、アートワーク、フォントを使えるよう、Hearts of Iron IVをインストールした状態にしておきます。

  2. サーバーをインストールします。

    npm install --global hoi4-agent-tools

  3. クライアント設定を出力します。

    hoi4-agent-tools-setup --print-client-config

    globalInstallブロックをClaude Code、Claude Desktop、CursorなどのJSONクライアントに貼り付けるか、codexTomlGlobalブロックをCodexのconfig.tomlに貼り付けます。

  4. エージェントのワークスペースとしてMODフォルダーを開き、作りたいものや修正したい内容を伝えます。

セットアップガイドでは、複数のMOD、明示的なゲームパス、ローカルのWikiスナップショット、および--discoverと--diagnoseを使ったトラブルシューティングについて説明しています。

Agent Toolsのデモを見るか、HOI4 Mod Setupを使って、MOD用のサーバーをインストールして接続してください。 Agentic HOI4 Modding（エージェント向けのスキルと指示）およびHOI4 Live Tools（起動中のゲームでのテスト）とともに、HOI4 MOD制作ツールキットを構成します。

例

mod のソースから描画された大きな国家方針ツリー

各ペアでは、ゲーム内の画像と、同じソースを使ったサーバーのプレビューを並べています。

ゲーム内サーバーのプレビュー
ゲーム内の国家方針ツリー国家方針ツリーのプレビュー
ゲーム内の歩兵技術フォルダー歩兵技術フォルダーのプレビュー
ゲーム内のビデオ設定ビデオ設定のプレビュー

詳しくはサンプルギャラリーをご覧ください。

ツール

このサーバーは、エージェントにプレビュー、ドキュメント、スクリプト分析、編集ツールを提供します。 エージェントはこれらをファイルエディターと組み合わせて、イベントやディシジョンの作成、スクリプトの修正、AI の重みの調整を行います。 統合に使う正確な名前、引数、結果については、ツールリファレンスをご覧ください。

FAQ

編集内容はどこに保存されますか？ 変更は mod フォルダーに書き込まれます。Git を使って確認したり、元に戻したりしてください。

ゲームを実行しますか？ いいえ。プレビューは mod のソースから生成されます。クリック操作、AI の選択、タイミングを実際に確認するには、HOI4 でゲームプレイをテストしてください。

設定

mod フォルダー内で起動すれば、サーバーに設定ファイルは必要ありません。 複数の mod を扱う場合や、ゲームが自動的に見つからない場合は、hoi4-agent-tools-setup --init を実行すると設定ファイルが作成されます。 リモート利用や共有利用では、hoi4-agent-tools-http により、トークンまたは OAuth を使って同じツールを HTTP 経由で提供できます。 設定リファレンスとHTTP ガイドをご覧ください。

ドキュメント

開発

npm ci
npm run check

貢献ガイドと開発ガイドをご覧ください。

ライセンス

Apache-2.0。LICENSEとサードパーティに関する通知をご覧ください。 Hearts of Iron IV のアートワークは Paradox Interactive に帰属します。このプロジェクトは Paradox Interactive とは無関係です。 ゲーム内の画像は、これらの比較用に提供されたものです。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。