🍋 Lemonade Stand MCP Server

🍋 Lemonade Stand MCP 服务

一个简单且可运行的 Model Context Protocol（MCP）服务示例，可让你通过 Claude Desktop 玩经典游戏 Lemonade Stand。

什么是 MCP？

Model Context Protocol（MCP）是一种开放标准，使 Claude 等 AI 模型能够与外部数据源和工具交互。本服务通过将经典游戏 Lemonade Stand 实现为一组 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 天或你的生意失败

游戏机制

• 天气系统：气温和天气状况会影响客流量
• 供应链：以不同价格购买杯子、柠檬、糖和冰块
• 定价策略：设置每杯柠檬水的价格，以平衡利润与需求
• 库存管理：冰块每天都会融化；请合理管理物资
• 客户需求：取决于天气、价格和可用库存

可用工具

此服务向 Claude 提供以下 MCP 工具：

• start_game：开始新的游戏会话
• get_game_state：查看当前状态、资金、库存和天气
• buy_supplies：购买杯子、柠檬、糖和冰块
• set_price：设置每杯柠檬水的价格
• 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 分析结果并决定下一步操作

这展示了如何使用 MCP 创建交互式体验，让 AI 模型能够维护状态、做出决策并与复杂系统交互。

贡献

如果你有改进建议或发现了错误，欢迎提交 issue 或 pull request。

许可证

MIT

---

作为 Model Context Protocol 实际应用的示例而构建。