Lemonade Stand

🚀 檸檬水攤 MCP 服務器

本項目是一個簡單且正在運行的模型上下文協議（MCP）服務器示例，藉助它，你能夠通過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服務器已成功連接！

✨ 主要特性

• 🌤️ 動態天氣系統影響銷售：遊戲中的天氣狀況會動態變化，不同的天氣會對檸檬水的銷售情況產生影響。
• 💰 商業模擬，包括供應與需求：模擬真實的商業環境，讓你體驗供應與需求之間的關係。
• 📊 價格策略和庫存管理：你需要制定合理的價格策略，並管理好檸檬水的庫存。
• 🏁 14天遊戲週期，帶有利潤跟蹤：遊戲以14天為一個週期，你可以即時跟蹤自己的利潤情況。
• 🎮 完全可通過Claude Desktop玩：你可以直接在Claude Desktop中暢玩這款遊戲。

📦 安裝指南

克隆倉庫

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

安裝依賴

npm install

配置Claude Desktop

找到Claude Desktop的配置文件，並按照以下示例進行配置：

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"
      ]
    }
  }
}

💻 使用示例

開始遊戲

1. 在終端或命令提示符中運行：

   node server.js
   

2. 打開Claude Desktop並導航到“工具”菜單。
3. 選擇“檸檬水攤MCP服務器”。
4. 開始與AI一起玩遊戲！

📚 詳細文檔

故障排除

問題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             # 此文件

如何工作

此MCP服務器實現了一個簡單的遊戲循環：

1. 服務器在內存中維護遊戲狀態。
2. 每個工具代表一個遊戲操作（購買、銷售等）。
3. 當Claude調用一個工具時，服務器更新遊戲狀態。
4. 結果以JSON格式返回給Claude。
5. Claude分析結果並決定下一步操作。

這展示了MCP如何用於創建交互式體驗，其中AI模型可以維護狀態、做出決策並與複雜系統互動。

貢獻

如果你有任何改進建議或發現任何問題，請隨時打開問題或提交拉取請求！

📄 許可證

本項目採用MIT許可證。

作為模型上下文協議實際應用的一個示例構建。