Lemonade Stand MCP Server

🚀 レモネードスタンド MCP サーバー

このサーバーは、シンプルで動作可能なサンプル MCP サーバーです。Claude Desktop を通じて、古典的なレモネードスタンドゲームをプレイすることができます。

🚀 クイックスタート

プロジェクトをすぐに起動するには、以下の手順に従ってください。

1. リポジトリをクローンします。

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

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

   npm install
   

3. Claude Desktop を設定します。

   • config.json ファイルを開きます。
   • ツールの部分に以下の内容を追加します。

     {
       "tools": [
         {
           "id": "lemonade-stand",
           "name": "レモネードスタンドゲーム",
           "description": "レモネードスタンドゲームをプレイするための MCP サーバー。",
           "type": "custom",
           "url": "http://localhost:3000"
         }
       ]
     }
     

   • Claude Desktop を再起動します。

✨ 主な機能

• 🌤️ 販売に影響を与える動的な天気システム
• 💰 供給と需要を含むビジネスシミュレーション
• 📊 戦略的な価格設定と在庫管理
• 🏁 利益追跡付きの 14 日間のゲーム周期
• 🎮 Claude Desktop から完全にプレイ可能

📦 インストール

前提条件

• Node.js（推奨 v20.11.1 以上）
• Claude Desktop

💻 使用例

基本的な使用法

ゲームを開始するには、以下の手順を実行してください。

1. サーバーを起動します。

   node server.js
   

2. Claude で lemonade-stand.start_game() ツールを呼び出して、新しいゲームを開始します。

3. 他のツールを使用してレモネードスタンドを管理します。例えば：

   • lemonade-stand.get_status()：現在のゲーム状態を取得します。
   • lemonade-stand.buy Supplies({ cups: 10, lemon: 5 })：補給品を購入します。
   • lemonade-stand.sell Lemonade({ price: 2.5, quantity: 20 })：レモネードを販売します。

📚 ドキュメント

ゲームメカニズム

このゲームは、シンプルなビジネスシナリオを模擬しており、プレイヤーはリソースと価格設定戦略を管理して利益を最大化する必要があります。以下は主要なメカニズムです。

• 天気システム：レモネードスタンドの販売量に影響を与えます。晴れの日は販売量が多く、雨の日は少なくなります。
• サプライチェーン：プレイヤーはコップ、レモン、その他の必需品を購入できます。
• 価格設定戦略：プレイヤーは価格を調整して販売量と利益に影響を与えることができます。

設定例

WSL ユーザー

Windows Subsystem for Linux を使用している場合は、パスを次のように変更してください。

%UserProfile%/Documents/Claude/config.json

npx の使用

直接以下のコマンドを実行できます。

npx server.js

トラブルシューティング

• ハンマーアイコンが見つからない：設定ファイルが正しいことを確認し、サーバーが実行中であることを確認してください。
• サーバーに接続できない：サーバーが実行中で、アドレスが正しいことを確認してください。

開発

サーバーコードを変更するには、以下の手順に従ってください。

1. server.js ファイルを変更します。
2. サーバーを再起動します。

   node server.js
   

3. Claude で変更をテストします。

プロジェクト構造

Lemonade-Stand-MCP-Server/
├── server.js              # メインの MCP サーバー実装
├── package.json           # Node.js の依存関係
└── README.md             # このファイル

仕組み

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

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

これは、MCP を使用して、AI モデルが状態を維持し、意思決定を行い、複雑なシステムと対話できるインタラクティブな体験を作成する方法を示しています。

🔧 技術詳細

この MCP サーバーは、古典的なレモネードスタンドゲームを一連のツールとして実装することで、MCP の仕組みをデモンストレーションしています。これらのツールは Claude が使用できます。サーバーはメモリ内でゲーム状態を維持し、Claude がツールを呼び出すとゲーム状態を更新します。結果は JSON 形式で Claude に返され、Claude はそれを分析して次のアクションを決定します。

📄 ライセンス

未記載

貢献

改善提案やエラーを見つけた場合は、いつでも問題を開いたり、プルリクエストを送信したりしてください。