内容
# 蜂单 MCP 服务器
一款提供蜂单外卖数据的 MCP 服务器，包括餐厅、菜单和菜品搜索，适用于克劳德桌面版和其他 MCP 客户端。
蜂单在五个叙利亚城市运营：**大马士革、阿勒颇、拉塔基亚、塔尔图斯、霍姆斯**。
---
## 工具
| 工具 | 描述 |
|------|-------------|
| `update_data(城市)` | 从蜂单抓取最新的餐厅和菜单数据（首次设置或刷新） |
| `get_db_status()` | 显示缓存的餐厅/物品数量和最后更新时间 |
| `list_restaurants(城市, 类别, 仅开放)` | 按城市或美食筛选餐厅 |
| `get_menu(餐厅 ID)` | 某餐厅的完整菜单，按分类分组 |
| `search_dishes(查询)` | 对所有缓存的菜单项进行全文搜索 |
| `get_categories(城市)` | 列出某城市可用的美食类别 |
---
## 安装
### 前提条件
- Python 3.11+
- [uv](https://docs.astral.sh/uv/)（推荐）或 pip
### 选项 A — uv（推荐）
```bash
git clone https://github.com/YOUR_USERNAME/beeorder-mcp
cd beeorder-mcp
uv venv && uv pip install -r requirements.txt
```
### 选项 B — pip
```bash
git clone https://github.com/YOUR_USERNAME/beeorder-mcp
cd beeorder-mcp
pip install -r requirements.txt
```
---
## 克劳德桌面版配置
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"beeorder": {
"command": "python",
"args": ["/absolute/path/to/beeorder-mcp/main.py"]
}
}
}
```
或使用 uv：
```json
{
"mcpServers": {
"beeorder": {
"command": "uv",
"args": ["run", "--directory", "/absolute/path/to/beeorder-mcp", "python", "main.py"]
}
}
}
```
编辑配置后重启克劳德桌面版。
---
## 首次使用
连接后，询问克劳德运行：
> "更新大马士革的蜂单数据"
这将触发 `update_data("damascus")`，抓取所有餐厅和菜单数据（完整城市需要约 2-5 分钟）。数据缓存在本地的 `data/beeorder.db` 中 - 后续查询即时生效。
---
## 支持的城市
| 城市 | 键 |
|----------|-----------|
| 大马士革 | damascus |
| 阿勒颇 | aleppo |
| 拉塔基亚 | latakia |
| 塔尔图斯 | tartous |
| 霍姆斯 | homs |
---
## 示例查询
- "大马士革现在有哪些开放的沙瓦玛店？"
- "显示餐厅 4380 的菜单"
- "搜索烤鸡菜品"
- "蜂单在阿勒颇有哪些美食类别？"
