🍋 Lemonade Stand MCP Server

🍋 Lemonade Stand MCP Server

site icon
2025.04.21 2
JavaScript游戏服务AI交互娱乐功能
Lemonade Stand MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,它实现了经典的柠檬水摊游戏,允许用户通过 Claude Desktop 进行游戏。该服务器展示了 MCP 如何使 AI 模型与外部数据源和工具交互,提供了一个完整的游戏体验,包括动态天气系统、业务模拟、战略定价和库存管理等功能。
View on GitHub

Overview

基本能力

产品定位

Lemonade Stand MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,实现了经典的柠檬水摊游戏,允许用户通过 Claude Desktop 进行游戏。

核心功能

  • 🌤️ 动态天气系统影响销售
  • 💰 业务模拟与供需关系
  • 📊 战略定价和库存管理
  • 🏁 14天游戏周期与利润跟踪
  • 🎮 通过 Claude Desktop 完全可玩

适用场景

  • 教育演示 MCP 协议的实际应用
  • 游戏开发与 AI 交互的示例
  • 业务模拟与战略决策的训练

工具列表

  • start_game: 开始新游戏会话
  • get_game_state: 检查当前状态、资金、库存和天气
  • buy_supplies: 购买杯子、柠檬、糖和冰
  • set_price: 设置每杯柠檬水的价格
  • sell_lemonade: 开始营业并查看每日结果
  • next_day: 进入下一天

常见问题解答

  1. Claude Desktop 中没有锤子图标:
  2. 确保 Claude Desktop 是最新版本
  3. 检查配置文件路径是否正确
  4. 验证 Node.js 是否安装并可访问
  5. 检查 Claude Desktop 日志

  6. 服务器连接错误:

  7. 验证配置中的服务器路径是否为绝对路径
  8. 直接测试服务器 node server.js
  9. 检查 Claude Desktop 日志中的错误

  10. WSL 特定问题:

  11. 确保 Node.js 在 WSL 中安装
  12. 使用 Node.js 二进制文件的完整路径
  13. 检查 WSL 是否正确安装并运行

使用教程

使用依赖

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/Lemonade-Stand-MCP-Server.git cd Lemonade-Stand-MCP-Server

  2. 安装依赖: bash npm install

  3. 找到 Claude Desktop 配置文件:

  4. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  5. Windows: %APPDATA%\Claude\claude_desktop_config.json

  6. 配置 Claude Desktop: json { "mcpServers": { "lemonade-stand": { "command": "node", "args": [ "/absolute/path/to/Lemonade-Stand-MCP-Server/server.js" ] } } }

  7. 重启 Claude Desktop

调试方式

  1. 测试服务器直接运行: bash node server.js

  2. 检查 Claude Desktop 日志:

  3. Windows: %APPDATA%\Claude\logs\
  4. macOS: ~/Library/Logs/Claude/

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。