柠

柠檬水摊位MCP服务器

@jimmcq/Lemonade-Stand-MCP-Server
0 Stars 17 次浏览 jimmcq 更新于 2026-08-23

一种模型上下文协议服务器，使克劳德桌面能够玩经典的柠檬水摊位商业模拟游戏，该游戏包含动态天气、定价策略和库存管理。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "lemonade-stand": {
      "args": [
        "/home/username/.nvm/versions/node/v20.11.1/bin/node",
        "/home/username/projects/Lemonade-Stand-MCP-Server/server.js"
      ],
      "command": "wsl.exe"
    }
  }
}

服务介绍

🍋 Lemonade Stand MCP 服务器

一个简单的、可工作的 Model Context Protocol (MCP) 服务器示例，允许您通过 Claude Desktop 玩经典的柠檬水摊游戏。

什么是 MCP？

Model Context Protocol (MCP) 是一种开放标准，使像 Claude 这样的 AI 模型能够与外部数据源和工具进行交互。这个服务器通过实现一组 Claude 可以使用的经典柠檬水摊游戏工具来展示 MCP 的工作原理。

特性

  • 🌤️ 影响销售的动态天气系统
  • 💰 供需模拟经营
  • 📊 战略定价和库存管理
  • 🏁 14 天的游戏周期并跟踪利润
  • 🎮 完全可以通过 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 服务器已连接！

游戏玩法

一旦服务器连接成功，只需与 Claude 开始一个新的聊天并说：

“使用可用的 MCP 工具玩一局完整的柠檬水摊游戏。”

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

故障排除

请注意，原文中的配置示例部分（WSL 用户和使用 NPX）似乎没有提供具体的内容，因此在翻译时保留了原始格式。如果需要进一步的帮助，请告诉我！

  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 模型可以维护状态、做出决策并与复杂系统交互。

贡献

如果您有改进的想法或发现错误，请随时打开问题或提交拉取请求。

许可证

MIT

作为 Model Context Protocol 应用示例构建。

查看源码 项目主页