# cuishan-catering-skill

**Repository Path**: ls8833/cuishan-catering-skill

## Basic Information

- **Project Name**: cuishan-catering-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 翠山餐饮 - 公开咨询 Skill

翠山集团餐饮对外咨询技能，基于 MCP 协议，只开放公开查询接口，不暴露内部运营数据，安全可控。

## 功能特点

- ✅ **安全可控**：仅开放公开咨询接口，不碰内部数据
- ✅ **MCP 架构**：云端 MCP 服务 + 本地 Skill 调用，对齐金谷园模式
- ✅ **核心功能**：
  - 门店信息查询
  - 外卖配送咨询
  - 常见问题解答
  - 最新活动公告
  - 美团排队取号（复用金谷园排队能力）

## 架构图

```
顾客 → OpenClaw Agent → 本地翠山 Skill → 云端 MCP 服务 → 公开数据库
                         ↑                  ↑
                    不暴露        只查询公开表，不碰内部数据
```

## 依赖

- `meituan-queue` - 美团排队取号（已内嵌复用）
- MCP 服务端运行需要：Python 3.10+, mcp, psycopg2-binary, fastapi, uvicorn

## 安装

当前源码已托管在 Gitee，可直接克隆到 OpenClaw skills 目录使用：

```bash
cd ~/.openclaw/workspace/skills
git clone https://gitee.com/ls8833/cuishan-catering-skill.git
```

等待 Skillhub 收录后可使用：
```
skillhub install cuishan-catering-skill
```

## MCP 服务部署

本仓库是 **AI Agent Skill（客户端）**，MCP 服务端代码请访问：
- Gitee（主仓库）：https://gitee.com/ls8833/cuishan-catering-mcp
- GitHub（镜像备份）：https://github.com/ls8833/cuishan-catering-mcp.git

服务端支持 Docker Compose 一键部署和手动 Systemd 部署两种方式，详见服务端仓库 README。

## 已实现接口

| 接口 | 功能 |
|------|------|
| `get_restaurant_list` | 获取所有公开门店列表 |
| `get_restaurant_info` | 获取单个门店详情 |
| `get_nearby_restaurants` | 查询附近门店 |
| `get_delivery_info` | 获取外卖配送信息 |
| `get_restaurant_faq` | 常见问题解答 |
| `get_latest_news` | 获取最新活动公告 |
| `health_check` | 健康检查 |

## 安全设计

- 仅查询 `public` schema 下的公开表
- **绝对不访问** `fast_food` 和 `chinese_food` 中的内部运营数据
- 只有查询权限，没有修改/删除权限
- 严格过滤返回字段，不泄露敏感信息

## 作者

翠山集团