Rpg MCP Servers

🚀 Roo Code AIダンジョン用RPG MCPサーバー

このプロジェクトは、Roo CodeでAIダンジョンスタイルのRPG体験を作成するためのMCP（Model Context Protocol）サーバーを実装しています。

🎲 最新のアップデート

• ダイス表記の修正: 現在、2d20kh1（有利状態）と2d20kl1（不利状態）がサポートされています。
• roll_checkツールの追加: 能力/技能チェックが簡素化されました。
• インベントリの強化: remove_itemとupdate_itemツールが追加されました。
• モンスター管理: NPC/モンスターの作成、取得、更新、一覧表示用のツールが追加されました。
• ストーリーとクエスト管理: ストーリーの進行状況を保存し、クエストを管理するためのツールが追加されました。
• 有利/不利状態の修正: D&D 5eルールが適切に実装されました。

詳細はupdate-summary.mdを参照してください。

📁 プロジェクト構成

• game-state-server/: SQLiteベースの永続的なゲーム状態管理
• combat-engine-server/: D&Dスタイルの戦闘メカニクスとダイスロール

📋 前提条件

始める前に、VS Code環境にRoo Codeをインストールして設定する必要があります。Roo Codeは、これらのMCPサーバーとやり取りするAI搭載のコーディングアシスタントです。

• 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 Experimentリポジトリ内のdungeon-master-mode.json設定を使用）。これにより、Rooを介してこれらのサーバーとやり取りできます。

🎮 使用方法

セットアップが完了すると、以下のことができます。

• 新しいキャラクターを作成する
• インベントリを管理する
• 戦闘エンカウントを実行する
• ストーリーの進行状況を追跡する
• すべてのセッションで永続的な状態を維持します！

✨ 主な機能

• 永続的な状態: ゲームデータはSQLiteデータベースに保存されます。
• 戦闘エンジン: 完全なD20システムが実装されています。
• 関心事の分離: 物語（AI）とメカニクス（MCPサーバー）が分離されています。
• 拡張性: 新しい機能を簡単に追加できます。