美酒与菜式 · 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 为同一语义)。
- SKILL.md — 行为与工具约定
- skill.json — 元数据与 MCP 段说明
- README.md — 接入概要
五、历史资料
更早的开放平台按杯/tenantId示例仍保留目录 /docs/sipsiip-glass-wine/ ,仅作存档;新项目请以本页与 sip-wine-food skill 为准。