Lemonade Stand

🚀 レモネードスタンド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の設定ファイルを見つけます：

   • 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サーバーが接続されていることを示します！

✨ 主な機能

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

📦 インストール

前提条件

• Node.js（v20.11.1以上が推奨）
• Claude Desktop
• npm（Node.jsと一緒に提供されます）

💻 使用例

ゲームの開始方法

ゲームを開始するには、以下の手順に従ってください：

1. ターミナルまたはコマンドプロンプトで次のコマンドを実行します：

   node server.js
   

2. Claude Desktopを開き、「ツール」メニューに移動します。

3. 「レモネードスタンドMCPサーバー」を選択します。

4. AIと一緒にゲームを始めましょう！

設定例

Windowsの例：

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

macOSの例：

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

📚 ドキュメント

モデルコンテキストプロトコル（MCP）とは？

モデルコンテキストプロトコル（MCP）は、ClaudeなどのAIモデルが外部のデータソースやツールとやり取りできるようにするオープン標準です。このサーバーは、クラシックなレモネードスタンドゲームを一連のツールとして実装することで、MCPの仕組みを示しています。これらのツールはClaude Desktopから使用できます。

サーバーの仕組み

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

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

これにより、AIモデルが状態を維持し、決定を下し、複雑なシステムとやり取りできるインタラクティブな体験を作成するためのMCPの使い方が示されています。

トラブルシューティング

問題1：サーバーを起動できない

• 症状：ターミナルに「モジュールが見つかりません」などのエラーが表示されます。
• 解決策：
  • リポジトリをクローンし、npm installを実行したことを確認してください。
  • パスが正しいことを確認してください。

問題2：Claude Desktopがサーバーを検出しない

• 症状：「ツール」メニューに「レモネードスタンドMCPサーバー」が表示されません。
• 解決策：
  • 設定ファイルが正しく編集されていることを確認してください。
  • Claude Desktopを再起動してください。

開発方法

このプロジェクトを変更するには、以下の手順に従ってください：

1. server.jsのロジックを変更して、新機能を追加または既存の機能を変更します。
2. ターミナルでnode server.jsを実行して、変更をテストします。
3. Claude Desktopを再起動して、更新を読み込みます。

プロジェクト構造

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

🔧 技術詳細

このサーバーは、Node.jsを使用して構築されており、Claude Desktopとの通信を可能にするMCPプロトコルを実装しています。サーバーは、ゲームの状態をメモリ内で管理し、Claudeからのリクエストに応じてゲーム状態を更新します。結果はJSON形式でClaudeに返され、Claudeはそれを分析して次の操作を決定します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

貢献

改善提案や問題があれば、自由にIssueを開いたり、Pull Requestを送信してください！

このプロジェクトは、モデルコンテキストプロトコルの実際のアプリケーションの例として構築されています。