星巴克 MCP 简介
Starbucks MCP 是面向 AI 应用的星巴克咖啡服务开放协议,提供 17 个工具能力。
什么是 MCP
Model Context Protocol(MCP)是一种用于在大模型与外部系统之间传递上下文与能力的开放协议。 MCP Server 通过标准化的 Tools / Resources / Prompts 三类入口, 向 AI Agent 暴露可被调用的能力。
星巴克 MCP 提供什么
星巴克 MCP 把咖啡场景中的核心服务封装成 17 个符合 MCP 规范的工具, 覆盖从"找店 → 选品 → 算价 → 下单 → 订单管理 → 会员权益"的完整下单链路:
- 门店发现:
search_stores、search_stores_by_product - 商品与套餐:
list_products、get_product、get_combo、list_promotions - 算价与下单(啡快 / 专星送):
calculate_pickup_price、create_pickup_order、calculate_delivery_price、create_delivery_order - 订单管理:
list_orders、get_order、cancel_order - 会员与权益:
get_user、list_coupons - 外送地址:
list_delivery_addresses、create_delivery_address
服务端信息
- Server URL:
https://uni.starbucks.com.cn/mcp-servers/starbucks - 协议版本:
2024-11-05 - Server 名称:
starbucks-server(initialize返回值) - 传输方式:标准 MCP over HTTP(JSON-RPC 2.0)
一个完整的下单链路示例
用户:"帮我点一杯热的燕麦拿铁,送到我家。"
Agent 调用顺序(每一步对应一个 MCP 工具):
list_delivery_addresses— 拿到收货地址与可配送门店;search_stores_by_product— 确认所选门店在售燕麦拿铁;get_product— 取规格(杯型 / 冷热)与客制化默认项;calculate_delivery_price— 试算价格并拿到temp_order_id;create_delivery_order— 提交订单,返回pay_url;get_order— 跟踪订单状态。
设计原则
- 贴近业务语义:工具命名与字段直接复用 MOP / MOD(啡快 / 专星送)业务概念;
- 强约束:
item_id不可跨biz_type复用,temp_order_id幂等,避免 Agent 误下单; - 可解释:每个工具的描述都包含"用户会怎么说",便于 LLM 路由。