jimmcq_Lemonade-Stand-MCP-Server

jimmcq_Lemonade-Stand-MCP-Server

0
entertainment_and_media

The Lemonade Stand MCP Server is an illustrative example of a Model Context Protocol server, showcasing how AI models can interact with external tools and data through the classic Lemonade Stand game. It features a dynamic weather system, strategic pricing, and inventory management, all playable via Claude Desktop.

🍋 Lemonade Stand MCP Server

A simple, working example of a Model Context Protocol (MCP) server that lets you play the classic Lemonade Stand game through Claude Desktop.

Features

  • Dynamic weather system affecting sales
  • Business simulation with supply and demand
  • Strategic pricing and inventory management
  • 14-day game cycle with profit tracking
  • Fully playable through Claude Desktop

Prerequisites

  • Node.js (v20.11.1 or higher recommended)
  • Claude Desktop
  • npm (comes with Node.js)

Playing the Game

Once the server is connected, start a chat with Claude and play Lemonade Stand using the available MCP tools.

Available Tools

  • start_game: Begin a new game session
  • get_game_state: Check current status, money, inventory, and weather
  • buy_supplies: Purchase cups, lemons, sugar, and ice
  • set_price: Set the price per cup of lemonade
  • sell_lemonade: Open for business and see daily results
  • next_day: Advance to the next day