项目简介

本项目 Lemonade Stand MCP Server 是一个实现了 Model Context Protocol (MCP) 的简单示例服务器，它将经典的柠檬水摊位游戏通过 MCP 协议暴露给支持 MCP 的客户端，例如 Claude Desktop。用户可以通过 Claude Desktop 与这个服务器互动，体验完整的游戏流程。

主要功能点

柠檬水摊位游戏模拟: 模拟经典的柠檬水摊位经营，包含天气影响、进货定价、销售结算等环节。
MCP协议实现: 实现了 MCP 协议的核心功能，包括：
- 工具 (Tools): 提供 'start_game', 'buy_supplies', 'set_price', 'sell_lemonade', 'next_day' 等工具，允许 Claude 控制游戏进程。
- 资源 (Resources): 以资源的形式暴露游戏状态，允许 Claude 获取当前游戏信息。
- Prompt 模板 (Prompts): 提供 'start_lemonade_game' Prompt，引导用户开始游戏。
JSON-RPC 通信: 使用 JSON-RPC 协议与 MCP 客户端进行通信。
Stdio 传输: 通过标准输入输出 (Stdio) 作为传输协议，简化部署和运行。

安装步骤

安装 Node.js: 确保你的电脑上已安装 Node.js (推荐 v20.11.1 或更高版本)。你可以从 Node.js官网下载安装。

克隆仓库: 使用 Git 克隆本项目到本地：

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

安装依赖: 在项目根目录下运行 npm 命令安装项目依赖：
```
npm install
```

服务器配置

要将此 MCP 服务器连接到 Claude Desktop，你需要修改 Claude Desktop 的配置文件 'claude_desktop_config.json'。

不同操作系统的配置文件路径如下：

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

打开 'claude_desktop_config.json' 文件，在 'mcpServers' 字段中添加以下配置 (如果不存在 'mcpServers' 字段，则创建它)：

{
  "mcpServers": {
    "lemonade-stand": {  // 服务器名称，可以自定义
      "command": "node", // 启动服务器的命令，这里使用 node
      "args": [
        "/absolute/path/to/Lemonade-Stand-MCP-Server/server.js" // 服务器脚本的绝对路径，请替换为你的实际路径
      ]
    }
  }
}

注意:

请将 '/absolute/path/to/Lemonade-Stand-MCP-Server/server.js' 替换为你本地仓库 'server.js' 文件的绝对路径。
配置完成后，重启 Claude Desktop 使配置生效。
成功连接后，Claude Desktop 界面上会显示一个锤子图标，表示 MCP 服务器已连接。

基本使用方法

启动 Claude Desktop: 确保 Claude Desktop 客户端已启动并成功加载 MCP 服务器。
开始新对话: 在 Claude Desktop 中开始一个新的聊天对话。

开始游戏: 在对话框中输入以下指令，即可开始柠檬水摊位游戏：

Play a complete game of Lemonade Stand using the MCP tools available.

或者，你也可以使用 Prompt 模板：

Start the "start_lemonade_game" prompt.

Claude 将会使用 MCP 工具与服务器进行交互，开始游戏并引导你进行后续操作。

跟随 Claude 指示: 根据 Claude 的指示，使用不同的工具（如购买材料、设定价格、售卖柠檬水、进入下一天）来经营你的柠檬水摊位。

享受你的柠檬水摊位经营之旅吧!

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息