Civ5 MCP

🚀 Civ 5 MCP

MCPを使用して、文明5（Civ 5）のゲームをエージェントに接続します。このモッドは、リアルタイムゲームからMCPサーバーへのIPCチャネルを作成し、エージェントがそれとやり取りできるようにします。

サンプルを参照してください。

このモッドの趣旨は、人間のプレイヤーが合理的に知り得る情報のみにアクセスできるようにすることです。例えば、奇跡の位置や未接触のプレイヤーの情報を漏らさないようにしています。このコンテキストの範囲は、このゲームでより上手くプレイするためのスーパーアドバイザーを作成することに焦点を当てています。

このプロジェクトは2つの部分で構成されています。ゲームモッド（いわゆるブリッジ）とMCPサーバーです。このモッドを使用するには、両方を使用する必要があります。

⚠️ 重要提示

これはWindowsのBrave New Worldでのみテストされています。

🚀 クイックスタート

1. 最新のリリースをダウンロードし、内容をMODSディレクトリに解凍します。 通常は、これは %USERPROFILE%\Documents\My Games\Sid Meier's Civilization 5\MODS です。

• ディレクトリは次のようになるはずです。

MODS/
  Civ5MCP_Bridge (v VERSION)/
      Civ5MCP_Bridge.modinfo
      ... たくさんの.luaファイル ...

2. ゲームを起動します。
3. MODSを選択します。
4. このモッドを有効にする小さなボタンをチェックします。
5. ゲームを設定します。
6. エージェントを設定して、server/civ5_mcp_server.pyを実行します。
7. 楽しんでください。

🔧 開発

ビルド

modinfoと定数ファイルはビルド時に生成されます。mod_config.jsonは、モッドと文明5が期待する形式でエクスポートされるファイルを記述しています。

# すべてのターゲットにはdocker-のバリアントがあります。例えば、make docker-lint
# 警告を受け取る
make lint

# 単体テストを実行する
make test

# 文明5が読み取れるディレクトリを生成する
make build

# オプション: 自動的に文明5のMODSフォルダにデプロイする
./tools/deploy.ps1

バージョニング

Luaのrockspecと文明5のバージョン形式は異なります。文明5は、ドットやダッシュのない文字列を期待します。したがって、文明5のバージョンはリビジョンを削除し、メジャーバージョンとマイナーバージョンをメジャー * 10 + マイナーに連結します。

ブリッジ

ゲーム状態は各ターンの開始時に取得され、SQLiteデータベースに書き込まれます。各新しいゲームは新しいセッションとして保存されます。セッションとターン番号は、状態のIDとして使用されます。ターン履歴と初期ゲーム設定は、このセッションIDを使用して保存されます。

⚠️ 重要警告

dataフィールドはJSONブロブであり、不安定と見なされます！

ブリッジは、非常に制限されたAPIでサンドボックス化されたLua 5.1.4で実行されます。ゲームはこのAPIを公開しており、これが私たちが使用できるほぼすべてのものです。

サーバーの実行

cd server

# サーバーが起動できることをテストする
uv run civ5_mcp_server.py

エラーが表示されない場合は、次のような設定を使用して、このサーバーをClaudeなどに追加できます。uvが起動できない場合は、uvのvenv Pythonバイナリを直接使用してみてください。

{
  "mcpServers": {
    "civ5": {
      "command": "uv",
      "args": ["run", "path/to/civ5_mcp_server.py"],
    }
  }
}