Lemonade-Stand-MCP-Server
Lemonade Stand MCP Server is a demonstration of the Model Context Protocol (MCP), allowing users to play the Lemonade Stand game through Claude Desktop. It features dynamic weather, business simulations, and is fully interactive with AI models.
🍋 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.
What is MCP?
Model Context Protocol (MCP) is an open standard that enables AI models like Claude to interact with external data sources and tools. This server demonstrates how MCP works by implementing the classic Lemonade Stand game as a set of tools that Claude can use.
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, simply start a new chat with Claude and say: "Play a complete game of Lemonade Stand using the MCP tools available."
Game Mechanics
- Weather System: Temperature and conditions affect customer traffic
- Supply Chain: Buy cups, lemons, sugar, and ice at different prices
- Price Strategy: Set your price per cup to balance profit and demand
- Inventory Management: Ice melts daily; manage your supplies wisely
- Customer Demand: Based on weather, price, and available inventory
Troubleshooting
- Ensure Claude Desktop is up to date
- Verify Node.js is installed and accessible
- Check Claude Desktop logs