柠檬摊点MCP服务器

Name: 柠檬摊点MCP服务器
Author: jimmcq

作者：jimmcq6 星标更新：2025-04-21

安装使用来源：spider==github.com

项目介绍

🍋 柠檬水摊位 MCP 服务器

这是一个简单的、可运行的 Model Context Protocol (MCP) 服务器示例，它允许您通过 Claude Desktop 玩经典的柠檬水摊位游戏。

什么是 MCP？

Model Context Protocol (MCP) 是一个开放标准，使像 Claude 这样的 AI 模型能够与外部数据源和工具进行交互。此服务器通过实现经典的柠檬水摊位游戏作为一组 Claude 可以使用的工具来演示 MCP 的工作原理。

特性

🌤️ 动态天气系统影响销售
💰 商业模拟，包括供需关系
📊 策略定价和库存管理
🏁 14 天的游戏周期，带有利润追踪
🎮 完全可以通过 Claude Desktop 玩

预备条件

Node.js（推荐版本 v2.11.1 或更高）
Claude Desktop
npm（随 Node.js 一起提供）

快速开始

克隆这个仓库：

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

安装依赖项：
```
npm install
```
找到您的 Claude Desktop 配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

配置 Claude Desktop：

{
  "mcpServers": {
    "lemonade-stand": {
      "command": "node",
      "args": [
        "/绝对路径/to/Lemonade-Stand-MCP-Server/server.js"
      ]
    }
  }
}

重启 Claude Desktop
您现在应该在 Claude Desktop 中看到一个锤子图标，表示 MCP 服务器已连接！

游戏玩法

一旦服务器连接成功，只需开始与 Claude 的新聊天并说：

“使用可用的 MCP 工具玩完整的柠檬水摊位游戏。”

Claude 将会：

开始新的游戏
分析天气状况
对供应和定价做出战略决策
报告每日结果
继续直到第 14 天或您的业务失败

游戏机制

天气系统：温度和天气状况会影响顾客流量
供应链：以不同的价格购买杯子、柠檬、糖和冰
定价策略：设置每杯柠檬水的价格以平衡利润和需求
库存管理：冰每天都会融化；明智地管理您的库存
客户需求：基于天气、价格和可用库存

可用工具

该服务器向 Claude 提供了这些 MCP 工具：

start_game：开始新的游戏会话
get_game_state：检查当前状态、资金、库存和天气
buy_supplies：购买杯子、柠檬、糖和冰
set_price：设置每杯柠檬水的价格
sell_lemonade：开始营业并查看每日结果
next_day：进入下一天

配置示例

对于 WSL 用户

{
  "mcpServers": {
    "lemonade-stand": {
      "command": "wsl.exe",
      "args": [
        "/home/用户名/.nvm/versions/node/v20.11.1/bin/node",
        "/home/用户名/projects/Lemonade-Stand-MCP-Server/server.js"
      ]
    }
  }
}

使用 NPX

{
  "mcpServers": {
    "lemonade-stand": {
      "command": "npx",
      "args": [
        "/路径/to/Lemonade-Stand-MCP-Server/server.js"
      ]
    }
  }
}

故障排除

Claude Desktop 中没有锤子图标：
- 确保 Claude Desktop 是最新版本
- 检查配置文件路径是否正确
- 验证 Node.js 是否已安装且可访问
- 查看 Claude Desktop 日志：
  - Windows: %APPDATA%\Claude\logs\
  - macOS: ~/Library/Logs/Claude/
服务器连接错误：
- 验证配置中的服务器路径是绝对路径
- 直接测试服务器 node server.js
- 查看 Claude Desktop 日志中的任何错误
WSL 特定问题：
- 确保 Node.js 在 WSL 中已安装
- 使用 Node.js 二进制文件的完整路径
- 检查 WSL 是否正确安装并运行

开发

要修改服务器：

编辑 server.js 以更改游戏机制或添加新工具
使用 node server.js 进行本地测试
重启 Claude Desktop 以加载更改

项目结构

Lemonade-Stand-MCP-Server/
├── server.js              # 主 MCP 服务器实现
├── package.json           # Node.js 依赖项
└── README.md             # 本文件

工作原理

此 MCP 服务器实现了简单的游戏循环：

服务器在内存中维护游戏状态
每个工具代表一个游戏动作（购买、出售等）
当 Claude 调用一个工具时，服务器更新游戏状态
结果以 JSON 格式返回给 Claude
Claude 分析结果并决定下一步行动

这展示了如何使用 MCP 创建互动体验，其中 AI 模型可以维持状态、做出决策并与复杂系统交互。

贡献

如果您有改进的想法或发现错误，请随时打开问题或提交拉取请求。

许可证

MIT

作为 Model Context Protocol 实际应用的一个示例而构建。