柠檬水摊 MCP 服务器

一个简单的、运行中的模型上下文协议（MCP）服务器示例，让你通过Claude Desktop玩经典的柠檬水摊游戏。

什么是MCP？

模型上下文协议（MCP）是一个开放标准，使AI模型如Claude能够与外部数据源和工具交互。这个服务器通过实现经典柠檬水摊游戏作为一组工具展示了MCP的工作原理，这些工具可以通过Claude Desktop使用。

特性

• 🌤️ 动态天气系统影响销售
• 💰 商业模拟，包括供应与需求
• 📊 价格策略和库存管理
• 🏁 14天游戏周期，带有利润跟踪
• 🎮 完全可通过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服务器已连接！

如何玩游戏

要开始游戏，请按照以下步骤操作：

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

   node server.js
   

2. 打开Claude Desktop并导航到“工具”菜单。

3. 选择“柠檬水摊MCP服务器”。

4. 开始与AI一起玩！

配置示例

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：无法启动服务器

• 症状：终端显示错误，如“找不到模块”。
• 解决方法：
  • 确保你已克隆仓库并运行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

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