Factorio Ai Companion

🚀 Factorio AI Companion

FactorioとClaude Codeの間でMCPプロトコルを介した双方向チャットブリッジです。

ステータス: ✅ フェーズ1完了 - チャットブリッジ動作中！

FactorioとClaude Codeの間でRCONを介した双方向チャットが動作しています。

🚀 クイックスタート

1. 依存関係のインストール

bun install

2. Factorioモッドのインストール

Windows:

xcopy /E /I factorio-mod "%APPDATA%\Factorio\mods\ai-companion"

Linux/Mac: factorio-mod/README.md を参照してください。

3. FactorioでRCONを設定する

%APPDATA%\Factorio\config\config.ini を編集し、以下の行を追加します（すでに存在する場合は追加不要）。

local-rcon-socket=127.0.0.1:34198
local-rcon-password=factorio

または、隠し設定GUIを使用する:

1. Factorioのメインメニューで、Ctrl+Alt を押し、設定 をクリックします。
2. "その他" タブに移動します。
3. local-rcon-socket を 127.0.0.1:34198 に設定します。
4. local-rcon-password を factorio に設定します。

4. Factorioのマルチプレイヤーを開始する

重要: RCONはマルチプレイヤーモードでのみ動作します（一人でプレイする場合でも）。

1. Factorioを起動します。
2. マルチプレイヤー → 新しいゲームをホスト（または ゲームを読み込む）を選択します。
3. セーブデータを選択し、プレイ をクリックします。
4. RCONは自動的に有効になります。

5. RCON接続をテストする（オプション）

bun run src/rcon/test-connection.ts

期待される出力:

✅ RCON connected on attempt 1
✅ Connection successful!
✅ RCON is working!

6. MCPサーバーを起動する

bun run src/index.ts

期待される出力:

🚀 Starting Factorio MCP Server...
✅ RCON connected on attempt 1
📡 RCON connected to Factorio
✅ MCP server running on stdio

💡 Server is ready! Claude Code can now use:
   - get_companion_messages
   - send_companion_message

7. Claude Codeを接続する

このプロジェクトのルートにある .mcp.json ファイルは、Claude Codeがこのサーバーを使用するように設定されています。 Claude Codeは必要に応じて自動的にMCPサーバーを起動します。

8. テストする！

Factorioのチャットで:

/companion Hello Claude! Can you help me?

Claude Codeで:

Use the get_companion_messages tool

Claudeは以下を見ることができます:

[
  {
    "player": "YourName",
    "message": "Hello Claude! Can you help me?",
    "tick": 12345
  }
]

Claudeは以下のように応答できます:

Use send_companion_message with "Hello! I'm here to help!"

Factorioでは、以下のように表示されます:

[AI Companion] Hello! I'm here to help!

✨ 利用可能なツール

get_companion_messages

/companion で始まるFactorioチャットの未読メッセージを取得します。 返り値: {player, message, tick} の配列

send_companion_message

AIコンパニオンとしてFactorioチャットにメッセージを送信します。 入力: { message: string }

🔧 アーキテクチャ

Factorio (Lua mod captures /companion chat)
    ↕ RCON (TCP port 27000)
Node.js MCP Server (Bun)
    ↕ MCP Protocol (stdio)
Claude Code (You!)

🏗️ 構築されたもの

• ✅ リトライロジック付きのRCONクライアント
• ✅ チャットメッセージパーサー
• ✅ FLEパターン付きのFactorio Luaモッド
• ✅ 2つのツールを持つMCPサーバー
• ✅ .mcp.json を介したClaude Code統合

フェーズ2（将来的な予定）

• AI制御のキャラクター
• ゲーム状態のイントロスペクション
• 自動建造/クラフト
• マルチエージェント協調

🛠️ トラブルシューティング

"Connection failed"

• Factorioが起動していることを確認してください。
• "Start as server" が有効になっていることを確認してください。
• RCONポートが27000であることを確認してください。
• RCONパスワードが "factorio" であることを確認してください。

"No messages"

• Factorioチャットで /companion <message> を入力してください（単に "companion" ではなく）。
• Factorio → モッドメニューでモッドが有効になっていることを確認してください。
• モッドをインストールした後、Factorioを再起動してください。

"Command not found"

• Bunがインストールされていることを確認してください: https://bun.sh
• bun --version を実行して確認してください。

💻 開発

# テストを実行する
bun test

# RCON接続をテストする
bun run src/rcon/test-connection.ts

# MCPサーバーを起動する
bun run src/index.ts

📄 クレジット

Factorio Learning Environment のパターンとベストプラクティスに触発されています。