🚀 柠檬水摊 MCP 服务器

本项目是一个简单且正在运行的模型上下文协议（MCP）服务器示例，借助它，你能够通过Claude Desktop畅玩经典的柠檬水摊游戏，为你带来别样的游戏体验。

🚀 快速开始

准备工作

在开始之前，你需要确保已经安装以下软件：

• Node.js（推荐使用v20.11.1或更高版本）
• Claude Desktop
• npm（会随Node.js一起安装）

操作步骤

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

3. 找到Claude Desktop配置文件：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
4. 配置Claude Desktop：

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

5. 重启Claude Desktop
6. 此时，你会在Claude Desktop中看到一个锤子图标，这表明MCP服务器已成功连接！

✨ 主要特性

• 🌤️ 动态天气系统影响销售：游戏中的天气状况会动态变化，不同的天气会对柠檬水的销售情况产生影响。
• 💰 商业模拟，包括供应与需求：模拟真实的商业环境，让你体验供应与需求之间的关系。
• 📊 价格策略和库存管理：你需要制定合理的价格策略，并管理好柠檬水的库存。
• 🏁 14天游戏周期，带有利润跟踪：游戏以14天为一个周期，你可以实时跟踪自己的利润情况。
• 🎮 完全可通过Claude Desktop玩：你可以直接在Claude Desktop中畅玩这款游戏。

📦 安装指南

克隆仓库

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

安装依赖

npm install

配置Claude Desktop

找到Claude Desktop的配置文件，并按照以下示例进行配置：

Windows 示例

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

macOS 示例

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

💻 使用示例

开始游戏

1. 在终端或命令提示符中运行：

   node server.js
   

2. 打开Claude Desktop并导航到“工具”菜单。
3. 选择“柠檬水摊MCP服务器”。
4. 开始与AI一起玩游戏！

📚 详细文档

故障排除

问题1：无法启动服务器

• 症状：终端显示错误，如“找不到模块”。
• 解决方法：
  • 确保你已克隆仓库并运行npm install。
  • 检查路径是否正确。

问题2：Claude Desktop未检测到服务器

• 症状：在“工具”菜单中看不到“柠檬水摊MCP服务器”。
• 解决方法：
  • 确保配置文件已正确编辑。
  • 重启Claude Desktop。

开发

如果你想对本项目进行修改，请按照以下步骤操作：

1. 修改server.js中的逻辑以添加新功能或更改现有功能。
2. 在终端运行node server.js测试更改。
3. 重启Claude Desktop加载更新。

项目结构

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

如何工作

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

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

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

贡献

如果你有任何改进建议或发现任何问题，请随时打开问题或提交拉取请求！

📄 许可证

本项目采用MIT许可证。

作为模型上下文协议实际应用的一个示例构建。