Sippai 门店美酒与菜式#

一句话：智能体 只 通过 MCP 工具完成「找店 → 瓶卖 / 杯卖酒单 → 菜式排序 → 酒 + 主推菜 推荐」； 对外只使用下文唯一网关。门店检索、酒单与菜式等业务能力由 Sippai 后端工程 api/sippai 实现，经 MCP 网关对外暴露工具。

对外地址（唯一）#

用途URL聚合网关前缀（本 skill 语境下唯一对外 API 域）****https://mcp.sipsiip.com/api本 skill 默认 MCP 会话入口（与网关 MCP_HTTP_MOUNT_PATH=/api/sippai 一致）https://mcp.sipsiip.com/api/sippai

• 远程宿主（HTTP / Streamable MCP）：只配置、只告知 https://mcp.sipsiip.com/api/sippai（及其文档约定的子路径）； 不要 在 skill 或用户可见说明里再写其它域名或直连业务网关 URL。
• 本地调试：可选用与线上一致的网关 URL；若在本机启动 MCP stdin/stdout 子进程联调仍须设置 SIPPAI_BASE_URL 与环境变量。 不要把 局域网或自建端口作为对外文档中的「官方数据入口」。

唯一入口（必读）#

• 必须使用：MCP 工具 sippai_search_restaurants、 sippai_get_restaurant_menus（会话入口见上表）。
• 禁止：在未经由 https://mcp.sipsiip.com/api 托管的 MCP、或未使用本 skill 所列工具的前提下，用其它 HTTP 入口获取同一批数据；禁止混用与本链路不一致的门店标识或解析方式。禁止向终端用户暴露「第二条」业务 API 基址。

能力概览#

项目说明覆盖范围已录入 Sippai 且状态正常的门店数据内容当前「正在使用」酒单下的瓶卖/杯卖酒款；在售菜品（ sort_order 靠前可作主推候选）业务实现所在（单仓后端）api/sippai：检索餐厅、门店酒单、 /v1/c/restaurants/... 菜品等均由该工程承载对外接入形态MCP： https://mcp.sipsiip.com/api/sippai实时性与门店生效酒单一致；以工具返回值为准密钥检索门店时后端可能校验集成密钥（与 Sippai 应用集成配置、 SIPPAI_MCP_API_KEYS 等一致）

工作流#

text

用户：「半山腰有什么杯卖？再给几道主推菜。」
       ↓
Step 1: sippai_search_restaurants(keyword="半山腰")
       ↓
若 records 多条 → 列出 name/address，请用户选一个 restaurantId（UUID）
若仅一条 → 直接取 restaurantId
       ↓
Step 2: sippai_get_restaurant_menus(restaurantId=<选定 UUID>)
       ↓
从返回 JSON 中取：
  bottleWineMenu.records[]  —— 瓶卖
  glassWineMenu.records[]   —— 杯卖
  dishesSoldOrderedByRestaurantMenuSort.records[] —— 主推菜候选（仅用返回字段做搭配话术）

行为规则#

1. restaurantId（UUID） 仅能通过 sippai_search_restaurants 取得后再调 sippai_get_restaurant_menus。禁止用其它体系的门店编号、租户类标识或非 MCP 提供的解析接口顶替。
2. 检索命中多家店 → 必须让用户选一。
3. 回答 只用工具返回字段；缺的写「接口未返回」； 绝不编造。
4. 杯卖 / 瓶卖 分别从 glassWineMenu / bottleWineMenu 读取。
5. 主推菜：优先 sort_order 较小的在售菜；勿夸大未在数据中的背书。
6. 酒 + 菜：搭配话术必须锚定在已返回的菜名与酒款上。

工具约定#

宿主通过 Model Context Protocol 连接 https://mcp.sipsiip.com/api/sippai（或本机等价联调会话）。工具行为应与 api/sippai 已实现接口一致： 门店检索 与 酒单、菜式 数据来源均为该后端；网关按 MCP 协议封装，宿主不要用 curl 绕过 MCP 自行拼 REST。

运维与密钥： sip.sippai.integration、 SIPPAI_MCP_API_KEYS、 SIPPAI_BASE_URL 等以服务部署与 api/sippai 应用配置为准， 不属于 向终端读者展开的 skill 正文。

宿主侧配置要点（远程）#

• MCP URL： https://mcp.sipsiip.com/api/sippai（认证方式以服务交付说明为准）。
• 不要 在 Cursor / SkillHub / 其它宿主配置里填写其它 API 根路径来获取同一批数据。

本机 stdio（仅开发）：须 MCP_TRANSPORT=stdio，并为本机 MCP 网关进程配置与后端可互通的 SIPPAI_BASE_URL；勿把该类地址当作对外公开的「官方数据入口」写入用户文档。

使用示例（上架与检索所需）#

以下示例说明 工具调用顺序；宿主须已配置 MCP 指向 https://mcp.sipsiip.com/api/sippai（或等价），并按交付方要求配置检索密钥（若启用）。

示例 1：店名 → 杯卖 + 主推菜#

1. 用户：「XX 餐厅有什么杯卖？推荐几道你们的主打菜。」
2. 调用 sippai_search_restaurants， keyword 填用户说的店名（或地址关键词）。
3. 若返回多条记录：列出 name、 address，请用户选定一家，取得其 restaurantId（UUID）。
4. 调用 sippai_get_restaurant_menus， restaurantId 为上一部选定值。
5. 回答：从 glassWineMenu 概括杯卖；从 dishesSoldOrderedByRestaurantMenuSort 取排序靠前若干道作为主推候选； 仅使用返回字段，缺项写「接口未返回」。

示例 2：仅问瓶卖#

1. 用户：「这家店瓶卖酒单有哪些？」（已能确定唯一门店时仍须先有 restaurantId。）
2. sippai_search_restaurants → 必要时让用户选店 → sippai_get_restaurant_menus。
3. 从 bottleWineMenu 组织回答。

仓库与实现#

路径说明**api/sippai**Sippai 后端。本 skill 用到的能力在此实现：例如 /v1/sippai/restaurants/search（供集成/MCP 先检索门店）、 /v1/c/restaurants/{id}/wine-list、 /dishes 等菜品与酒单数据。宿主侧仍 只经由 https://mcp.sipsiip.com/api/sippai 的 MCP 工具访问，不向用户暴露直连后端的拼装 URL。