Lemonade Stand

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

javascript

7

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jimmcq-lemonade-stand-mcp-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/Lemonade-Stand-MCP-Server/server.js"
      ]
    }
  }
}

You can run an MCP server that lets you play Lemonade Stand through Claude Desktop. This server exposes game actions as MCP tools, so Claude can start a game, manage inventory, adjust pricing, advance days, and see daily results while maintaining game state across interactions.

How to use

You connect Claude Desktop to the Lemonade Stand MCP Server, then start a new chat with Claude and request to play a complete Lemonade Stand game using the MCP tools. Claude will begin a new game, check weather and demand, buy supplies, set prices, open for business, and progress through each day up to Day 14 or until the business ends.

The server provides these actions as tools you can invoke from Claude: start_game, get_game_state, buy_supplies, set_price, sell_lemonade, and next_day. Each tool updates the in-memory game state and returns results you can analyze to decide next actions.

How to install

Prerequisites you need to have before running the server are Node.js (version 20.11.1 or higher recommended) and npm, as well as Claude Desktop.

Step 1: Clone the project and move into the folder.

git clone https://github.com/yourusername/Lemonade-Stand-MCP-Server.git
cd Lemonade-Stand-MCP-Server

Step 2: Install dependencies.

npm install

Step 3: Configure Claude Desktop to load the MCP server. Create or edit the config so Claude Desktop can connect to the local server. Use the following example configuration, which points Claude Desktop to run the server with Node.

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

Step 4: Restart Claude Desktop to apply the new MCP connection. You should see an indicator that the MCP server is connected.

Additional setup notes

If you are on Windows or macOS and you need an alternative runtime, you can run the server via WSL or NPX as shown in examples below. Each variant uses a complete command sequence to start the server.

Available tools

start_game

Begin a new game session and establish a fresh game context for Claude to interact with.

get_game_state

Return the current money, inventory, and weather status so Claude can decide next actions.

buy_supplies

Purchase cups, lemons, sugar, and ice to build your inventory for the 14-day cycle.

set_price

Set the price per cup of lemonade to influence demand and profitability.

sell_lemonade

Open the stand for business and generate daily results and revenue.

next_day

Advance the game to the next day, updating weather effects and inventory decay.