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

💻 使用示例

基礎用法

要開始玩遊戲，請執行以下步驟：

# 啟動服務器
node server.js

在 Claude 中調用工具 lemonade-stand.start_game() 開始新遊戲。

高級用法

使用其他工具管理你的檸檬汁攤，例如：

# 獲取當前遊戲狀態
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 是一個開放標準，使 AI 模型（如 Claude）能夠與外部數據源和工具交互。

工作流程

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

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

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

📄 許可證

文檔未提及相關信息，故跳過該章節。

🤝 貢獻

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