🍋 Lemonade Stand MCP Server

What is 🍋 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. It demonstrates how MCP enables AI models to interact with external tools and maintain game state.

How to use 🍋 Lemonade Stand MCP Server?

Clone the repository, install dependencies with npm install, and configure Claude Desktop by adding a JSON entry in claude_desktop_config.json pointing to server.js. After restarting Claude, start a new chat and ask it to "Play a complete game of Lemonade Stand using the MCP tools available."

Key features of 🍋 Lemonade Stand MCP Server

• 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

Use cases of 🍋 Lemonade Stand MCP Server

• Learn how MCP works through a hands‑on example
• Play the classic Lemonade Stand game via Claude Desktop
• Demonstrate AI‑driven strategic decision‑making
• Experiment with stateful MCP tool interactions

FAQ from 🍋 Lemonade Stand MCP Server

What are the prerequisites?

Node.js v20.11.1 or higher, Claude Desktop, and npm (comes with Node.js).

How do I know the server is connected?

A hammer icon appears in Claude Desktop when the MCP server is connected.

How do I troubleshoot a missing hammer icon?

Ensure Claude Desktop is up to date, verify the configuration file path is correct, check that Node.js is accessible, and review Claude Desktop logs (Windows: %APPDATA%\Claude\logs\, macOS: ~/Library/Logs/Claude/).

What tools does the server expose to Claude?

start_game, get_game_state, buy_supplies, set_price, sell_lemonade, and next_day.

Can I play the game on WSL?

Yes. Use a WSL‑specific configuration with the full path to the Node.js binary inside the WSL environment.