Lemonade Stand

🚀 柠檬水摊 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天游戏周期，带有利润跟踪，清晰了解经营状况。
• 🎮 完全可通过Claude Desktop玩，操作便捷。

📦 安装指南

克隆仓库

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

安装依赖

npm install

配置Claude Desktop

找到Claude Desktop配置文件并按以下内容修改：

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

重启Claude Desktop

重启后，若看到锤子图标，则表示MCP服务器已成功连接。

💻 使用示例

基础用法

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

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

   node server.js
   

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

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

4. 开始与AI一起玩！

高级用法

若你想修改游戏逻辑，可以按照以下步骤操作：

1. 修改server.js中的逻辑以添加新功能或更改现有功能。
2. 在终端运行node server.js测试更改。
3. 重启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：无法启动服务器

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

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

• 症状：在“工具”菜单中看不到“柠檬水摊MCP服务器”。
• 解决方法：
  • 确保配置文件已正确编辑。
  • 重启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许可证。

贡献

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

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