Rpg MCP Servers

🚀 Roo Code AI地下城的RPG MCP服務器

本項目實現了MCP（模型上下文協議）服務器，用於在Roo Code中創建類似AI地下城風格的角色扮演遊戲（RPG）體驗。

🚀 快速開始

前提條件

在開始之前，請確保你已經在VS Code環境中安裝並配置了Roo Code。Roo Code是一個由人工智能驅動的編碼助手，它將與這些MCP服務器進行交互。

• 安裝Roo Code：
  • 從VS Code市場安裝。
  • 或者通過命令行界面（CLI）安裝：code --install-extension RooVeterinaryInc.roo-cline
• 配置AI提供商：安裝完成後，在Roo Code擴展設置中添加你的AI模型API密鑰（例如，OpenAI、Anthropic）。
• 有關Roo Code的更多詳細信息，請訪問Roo Code網站或官方文檔。

設置說明

1. 為兩個服務器安裝依賴項：

   cd game-state-server
   npm install
   npm run build
   
   cd ../combat-engine-server
   npm install
   npm run build
   

2. 配置MCP服務器： 每個服務器都可以通過環境變量或其各自目錄中的 .env 文件進行配置。
   • 遊戲狀態服務器（game - state - server）：
     • DATABASE_PATH：SQLite數據庫文件的路徑（例如，./data/game.db）。默認值為 ./data/game.db。
     • PORT：服務器監聽的端口（例如，3001）。默認值為 3001。
   • 戰鬥引擎服務器（combat - engine - server）：
     • PORT：服務器監聽的端口（例如，3002）。默認值為 3002。 game - state - server 的 .env 文件示例：

   DATABASE_PATH=./data/my_game.db
   PORT=3001
   

3. 啟動MCP服務器： 要運行服務器，請導航到它們各自的目錄並使用 npm start 或 node dist/index.js。 例如：

   cd game-state-server
   npm start
   # 在新的終端中：
   cd ../combat-engine-server
   npm start
   

4. Roo Code集成： 要在Roo Code中使用這些服務器，你需要在 mcp_settings.json 文件中進行配置。該文件通常位於 C:\Users\YOUR_USERNAME\AppData\Roaming\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json。 以下是每個服務器的配置示例。將 cwd（當前工作目錄）路徑調整為你克隆或放置 rpg - mcp - servers 倉庫並構建服務器的位置。

   {
     "mcpServers": {
       // ... 其他服務器 ...
       "rpg-game-state": {
         "name": "rpg-game-state-server",
         "command": "node",
         "args": [
           "dist/index.js"
         ],
         "cwd": "PATH_TO_YOUR_PROJECT/rpg-mcp-servers/game-state-server",
         "enabled": true,
         "alwaysAllow": [
           "create_character",
           "get_character",
           "get_character_by_name",
           "list_characters",
           "update_character",
           "add_item",
           "get_inventory",
           "save_world_state",
           "get_world_state",
           "create_npc",
           "create_npc_group",
           "get_npc",
           "list_npcs",
           "update_npc",
           "remove_npc",
           "save_story_progress",
           "add_quest",
           "get_active_quests",
           "update_quest_state",
           "assign_quest_to_character"
         ]
       },
       "rpg-combat-engine": {
         "name": "rpg-combat-engine-server",
         "command": "node",
         "args": [
           "dist/index.js"
         ],
         "cwd": "PATH_TO_YOUR_PROJECT/rpg-mcp-servers/combat-engine-server",
         "enabled": true,
         "alwaysAllow": [
           "roll_dice",
           "attack_roll",
           "damage_roll",
           "saving_throw",
           "get_combat_log",
           "start_combat",
           "end_turn",
           "next_turn"
         ]
       }
       // ... 其他服務器 ...
     }
   }
   

   注意：
   • 將 PATH_TO_YOUR_PROJECT 替換為你係統上 rpg - mcp - servers 目錄的實際絕對路徑。例如，如果你將其克隆到 C:\projects\rpg - mcp - servers，那麼 game - state - server 的 cwd 應為 C:/projects/rpg - mcp - servers/game - state - server。
   • alwaysAllow 數組列出了Roo Code每次使用時無需用戶明確許可的工具。你可以自定義此列表。
   • start_combat 工具已添加到 rpg - combat - engine - server 的 mcp_settings.json 示例中。請確保該工具在服務器中實際實現。
5. 為AI地下城主創建自定義模式（例如，在AI地下城實驗倉庫中使用 dungeon - master - mode.json 配置），以便通過Roo與這些服務器進行交互。

使用方法

設置完成後，你可以：

• 創建新角色
• 管理物品欄
• 進行戰鬥遭遇
• 跟蹤故事進度
• 並且所有操作在不同會話之間都能保持持久狀態！

✨ 主要特性

• 持久狀態：遊戲數據存儲在SQLite數據庫中
• 戰鬥引擎：完整實現D20系統
• 關注點分離：敘事（AI）與機制（MCP服務器）分離
• 可擴展性：易於添加新功能

🎲 最新更新

• 修復骰子表示法：現在支持 2d20kh1（優勢）和 2d20kl1（劣勢）
• 添加 roll_check 工具：簡化能力/技能檢查
• 增強物品欄功能：添加了 remove_item 和 update_item 工具
• 怪物管理：添加了創建、獲取、更新和列出NPC/怪物的工具。
• 故事和任務管理：添加了保存故事進度和管理任務的工具。
• 修正優勢/劣勢規則：正確實現了D&D 5e規則 完整詳情請參閱 update - summary.md。

📚 詳細文檔

項目結構

• game - state - server/：基於SQLite的持久遊戲狀態管理
• combat - engine - server/：D&D風格的戰鬥機制和骰子滾動