美酒与菜式 · MCP 对接(sip-wine-food)

面向豆包、通义、Cursor 等宿主:门店检索 → 瓶卖/杯卖酒单 → 按店内排序的在售菜式,用于酒与主推菜两类推荐。数据只通过 MCP 会话拉取 ,业务由 Sippai 后端实现。

说明:本页为说明与静态资源入口。在助手 / IDE 内仍需按要求配置 MCP 指向下方唯一网关会话地址;仅把网页链接粘贴进对话通常不会自动完成连接

一、对外唯一网关(宿主配置用)

请先与服务端交付口径确认认证方式(如 Bearer、密钥等);本页不替代运维文档。

用途URL
聚合网关前缀https://mcp.sipsiip.com/api
默认 MCP 会话入口(Sippai 挂载)https://mcp.sipsiip.com/api/sippai

不要在宿主里再填一套「直连业务网关」的根地址来拉同一批数据:门店检索与酒菜能力在 api/sippai 工程中实现,对智能体只经由上述 MCP 暴露工具。

二、能力与工具链

  • sippai_search_restaurants:按关键词或经纬度+半径分页检索门店,得到 restaurantId(UUID)。服务端可能校验集成密钥。
  • sippai_get_restaurant_menus:拉取门店瓶卖 / 杯卖酒单及按菜单排序的在售菜式(靠前的可作主推候选)。

多门店命中时需请用户选一,不得替你猜。禁止编造价格、菜式或配额。

三、最小工作流

Step 1: sippai_search_restaurants(keyword=「用户说的店名或地点」)
若多条 → 展示 name / address,请用户选一个 restaurantId
若一条 → 取该 restaurantId

Step 2: sippai_get_restaurant_menus(restaurantId=选定的 UUID)
从返回中取 bottleWineMenu / glassWineMenu / dishes,组织「酒 + 主推菜」说明(仅用返回字段)

四、与本站静态文件

以下内容位于 public/docs/sip-wine-food/ ,与站内路由 /ai/getwinefood(SPA)路径互不冲突 ,便于下载进知识库或放入 IDE Skill 目录(与仓库 skill/sip-wine-food 为同一语义)。

本站说明页:https://sipsiip.com/ai/getwinefood/ai/getwine跳转至此页。示例静态资源直链:https://sipsiip.com/docs/sip-wine-food/SKILL.md

五、历史资料

更早的开放平台按杯/tenantId示例仍保留目录 /docs/sipsiip-glass-wine/ ,仅作存档;新项目请以本页与 sip-wine-food skill 为准。