Factorio Ai Companion

🚀 異星工廠AI助手

這是一個通過MCP協議在異星工廠（Factorio）和Claude Code之間建立的雙向聊天橋樑。

🚀 快速開始

狀態：✅ 第一階段完成 - 聊天橋樑已正常工作！

通過RCON，異星工廠和Claude Code之間已實現雙向聊天。

📦 安裝指南

1. 安裝依賴項

bun install

2. 安裝異星工廠模組

Windows系統：

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

Linux/Mac系統： 請查看 factorio-mod/README.md

3. 在異星工廠中配置RCON

編輯 %APPDATA%\Factorio\config\config.ini 文件，並添加以下行（如果文件中尚未存在）：

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

或者使用隱藏的設置圖形界面：

1. 在異星工廠主菜單中，按下 Ctrl + Alt 組合鍵，然後點擊 設置。
2. 切換到 “其他” 選項卡。
3. 將 local-rcon-socket 設置為 127.0.0.1:34198。
4. 將 local-rcon-password 設置為 factorio。

4. 啟動異星工廠多人遊戲

重要提示：RCON僅在多人遊戲模式下可用（即使是單人遊戲）。

1. 啟動異星工廠。
2. 選擇 多人遊戲 → 創建新遊戲（或 加載遊戲）。
3. 選擇你的存檔，然後點擊 開始遊戲。
4. RCON將自動啟用。

5. 測試RCON連接（可選）

bun run src/rcon/test-connection.ts

預期輸出：

✅ RCON在第1次嘗試時連接成功
✅ 連接成功！
✅ RCON正常工作！

6. 啟動MCP服務器

bun run src/index.ts

預期輸出：

🚀 正在啟動異星工廠MCP服務器...
✅ RCON在第1次嘗試時連接成功
📡 RCON已連接到異星工廠
✅ MCP服務器在標準輸入輸出上運行

💡 服務器已準備就緒！Claude Code現在可以使用以下工具：
   - get_companion_messages
   - send_companion_message

7. 連接Claude Code

項目根目錄下的 .mcp.json 文件已配置Claude Code使用此服務器。Claude Code將在需要時自動啟動MCP服務器。

8. 進行測試！

在異星工廠聊天框中：

/companion 你好，Claude！你能幫我嗎？

在Claude Code中：

使用 get_companion_messages 工具

Claude將看到：

[
  {
    "player": "你的名字",
    "message": "你好，Claude！你能幫我嗎？",
    "tick": 12345
  }
]

Claude可以回覆：

使用 send_companion_message 工具發送消息 "你好！我來幫你了！"

在異星工廠中，你將看到：

[AI助手] 你好！我來幫你了！

💻 使用示例

可用工具

get_companion_messages

從異星工廠聊天中獲取以 /companion 開頭的未讀消息。 返回值： {player, message, tick} 數組

send_companion_message

以AI助手的身份向異星工廠聊天發送消息。 輸入： { message: string }

🔧 技術細節

架構

異星工廠（Lua模組捕獲 /companion 聊天消息）
    ↕ RCON（TCP端口27000）
Node.js MCP服務器（Bun）
    ↕ MCP協議（標準輸入輸出）
Claude Code（用戶端）

已完成的功能

• ✅ 帶有重試邏輯的RCON客戶端
• ✅ 聊天消息解析器
• ✅ 具有FLE模式的異星工廠Lua模組
• ✅ 包含2個工具的MCP服務器
• ✅ 通過 .mcp.json 實現Claude Code集成

第二階段（未來計劃）

• AI控制的角色
• 遊戲狀態內省
• 自動化建造/製作
• 多智能體協作

🛠️ 故障排除

"連接失敗"

• 確保異星工廠正在運行。
• 檢查是否啟用了 "作為服務器啟動"。
• 驗證RCON端口是否為27000。
• 驗證RCON密碼是否為 "factorio"。

"沒有消息"

• 在異星工廠聊天框中輸入 /companion <消息>（而不僅僅是 "companion"）。
• 檢查異星工廠 → 模組菜單中是否啟用了該模組。
• 安裝模組後重啟異星工廠。

"命令未找到"

• 確保已安裝Bun：https://bun.sh
• 運行 bun --version 進行驗證。

🛠️ 開發

# 運行測試
bun test

# 測試RCON連接
bun run src/rcon/test-connection.ts

# 啟動MCP服務器
bun run src/index.ts

📄 鳴謝

本項目受 異星工廠學習環境 的模式和最佳實踐啟發。