🍋 Lemonade Stand MCP Server

🍋 Lemonade Stand MCP サーバー

Claude Desktop を通じて、昔ながらのレモネードスタンドゲームをプレイできる、Model Context Protocol（MCP）サーバーのシンプルな動作例です。

MCP とは？

Model Context Protocol（MCP）は、Claude のような AI モデルが外部のデータソースやツールとやり取りできるようにするオープンスタンダードです。このサーバーでは、昔ながらのレモネードスタンドゲームを Claude が利用できるツール群として実装し、MCP の仕組みを紹介します。

機能

• 🌤️ 売上に影響する動的な天候システム
• 💰 需要と供給を取り入れたビジネスシミュレーション
• 📊 戦略的な価格設定と在庫管理
• 🏁 利益を記録する14日間のゲームサイクル
• 🎮 Claude Desktop から最後までプレイ可能

前提条件

• Node.js（v20.11.1 以上を推奨）
• Claude Desktop
• npm（Node.js に付属）

クイックスタート

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/Lemonade-Stand-MCP-Server.git
   cd Lemonade-Stand-MCP-Server
   

2. 依存関係をインストールします：

   npm install
   

3. Claude Desktop の設定ファイルを探します：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

4. Claude Desktop を設定します：

   {
     "mcpServers": {
       "lemonade-stand": {
         "command": "node",
         "args": [
           "/absolute/path/to/Lemonade-Stand-MCP-Server/server.js"
         ]
       }
     }
   }
   

5. Claude Desktop を再起動します

6. Claude Desktop にハンマーのアイコンが表示され、MCP サーバーが接続されたことを確認できます！

ゲームのプレイ

サーバーに接続したら、Claude と新しいチャットを開始して、次のように伝えます：

「利用可能な MCP ツールを使って、Lemonade Stand を最後までプレイしてください。」

Claude は次の手順を実行します：

1. 新しいゲームを開始する
2. 天候を分析する
3. 仕入れと価格設定について戦略的な判断をする
4. 毎日の結果を報告する
5. 14日目に到達するか、ビジネスが失敗するまで続ける

ゲームの仕組み

• 天候システム：気温と天候が来客数に影響します
• サプライチェーン：カップ、レモン、砂糖、氷をそれぞれ異なる価格で購入します
• 価格戦略：利益と需要のバランスを取りながら、カップ1杯あたりの価格を設定します
• 在庫管理：氷は毎日溶けるため、仕入れを賢く管理します
• 顧客需要：天候、価格、利用可能な在庫に基づいて決まります

利用可能なツール

サーバーは次の MCP ツールを Claude に公開します：

• start_game：新しいゲームセッションを開始する
• get_game_state：現在の状態、所持金、在庫、天候を確認する
• buy_supplies：カップ、レモン、砂糖、氷を購入する
• set_price：レモネード1杯あたりの価格を設定する
• sell_lemonade：営業を開始し、その日の結果を確認する
• next_day：翌日に進む

設定例

WSL ユーザー向け

{
  "mcpServers": {
    "lemonade-stand": {
      "command": "wsl.exe",
      "args": [
        "/home/username/.nvm/versions/node/v20.11.1/bin/node",
        "/home/username/projects/Lemonade-Stand-MCP-Server/server.js"
      ]
    }
  }
}

NPX を使用する場合

{
  "mcpServers": {
    "lemonade-stand": {
      "command": "npx",
      "args": [
        "/path/to/Lemonade-Stand-MCP-Server/server.js"
      ]
    }
  }
}

トラブルシューティング

1. Claude Desktop にハンマーのアイコンが表示されない場合：

   • Claude Desktop が最新の状態であることを確認します
   • 設定ファイルのパスが正しいことを確認します
   • Node.js がインストールされ、アクセス可能であることを確認します
   • Claude Desktop のログを次の場所で確認します：
     • Windows：%APPDATA%\Claude\logs\
     • macOS：~/Library/Logs/Claude/

2. サーバー接続エラーが発生する場合：

   • 設定内のサーバーパスが絶対パスであることを確認します
   • node server.js を実行してサーバーを直接テストします
   • Claude Desktop のログにエラーがないか確認します

3. WSL 固有の問題：

   • WSL に Node.js がインストールされていることを確認します
   • Node.js バイナリへのフルパスを使用します
   • WSL が正しくインストールされ、実行中であることを確認します

開発

サーバーを変更するには：

1. server.js を編集して、ゲームの仕組みを変更するか、新しいツールを追加します
2. node server.js を実行してローカルでテストします
3. Claude Desktop を再起動して、変更を読み込みます

プロジェクト構成

Lemonade-Stand-MCP-Server/
├── server.js              # Main MCP server implementation
├── package.json           # Node.js dependencies
└── README.md             # This file

仕組み

この MCP サーバーは、シンプルなゲームループを実装しています：

1. サーバーはゲームの状態をメモリ上に保持します
2. 各ツールはゲームのアクション（購入、販売など）を表します
3. Claude がツールを呼び出すと、サーバーがゲームの状態を更新します
4. 結果は JSON として Claude に返されます
5. Claude は結果を分析し、次のアクションを決定します

この例は、AI モデルが状態を保持し、判断を下し、複雑なシステムとやり取りできるインタラクティブな体験の作成に、MCP をどのように利用できるかを示しています。

コントリビューション

改善案がある場合やバグを見つけた場合は、お気軽にイシューを作成するか、プルリクエストを送信してください。

ライセンス

MIT

---

Model Context Protocol の実践例として構築されました。