mcp-ucp

@codespar/mcp-ucp

已弃用：没有可用的在线端点。 于 2026-09-27 测得：commerce.googleapis.com 对所有路径均返回 Google 的通用 Error 404 (Not Found) 页面；而 sandbox.commerce.googleapis.com（与 UCP_SANDBOX=true 搭配使用）会因 TLS 握手失败，因为该处提供的证书涵盖 *.googleapis.com，不涵盖额外的子域标签。UCP 是一项开放规范，并非 Google 托管的 API。此服务中的工具均无法访问任何服务。该软件包已在 npm 上弃用，仅保留在此代码库中供参考。如果你有可用的端点，请使用 UCP_BASE_URL 将服务指向该端点。若要恢复此软件包，请在 mcp-dev-latam 中提交问题，并附上提供商记录的基础 URL。

面向 Google UCP 的 MCP 服务——用于 Agent 购物、购物车、结账、订单和配送的通用商务协议

什么是 UCP？

通用商务协议（UCP） 是 Google 面向 Agent 商务的开放标准。它支持 AI Agent 自主发现商品、创建购物车、结账、管理订单和跟踪配送，无需抓取屏幕内容或为商家单独集成。

UCP 与 AP2（支付处理）和 A2A（Agent 间互操作性）协同工作，并以 MCP 作为传输层。

快速开始

Claude Desktop

{
  "mcpServers": {
    "ucp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-ucp"],
      "env": {
        "UCP_API_KEY": "your-key",
        "UCP_MERCHANT_ID": "your-merchant-id"
      }
    }
  }
}

Claude Code

claude mcp add ucp -- npx @codespar/mcp-ucp

工具（20 个）

工具	用途
search_products	搜索商家的商品目录。
get_product	获取商品详细信息，包括定价、款式、库存情况和评价
check_availability	检查指定地点的商品库存和配送情况
list_merchants	列出兼容 UCP 的商家，可选按类别和地区筛选
create_cart	为商家创建新的购物车
add_to_cart	将商品添加到购物车
remove_from_cart	从购物车中移除商品
get_cart	获取购物车内容、商品总价、税费和运费预估
clear_cart	移除购物车中的所有商品
get_delivery_options	获取购物车可用的运输和配送选项
initiate_checkout	开始购物车的结账流程。
apply_payment	为结账会话应用支付方式。
confirm_order	确认并提交订单。
get_order	获取订单详细信息，包括商品、状态、支付和运输信息
list_orders	列出订单，可选使用筛选条件
cancel_order	取消待处理或已确认的订单
request_return	为已送达的订单申请退货或退款
track_shipment	获取订单的实时货运跟踪详情
link_identity	关联买家身份，以便在不同商家之间实现个性化服务并查看订单历史
get_profile	获取买家资料、偏好设置和已关联的商家

UCP + AP2 + A2A — 完整技术栈

AI Agent
  └── MCP (tool interface)
       └── UCP (commerce: discover → cart → checkout → order → delivery)
            ├── A2A (agent-to-agent discovery & communication)
            └── AP2 (payment: authorize → execute → settle)

环境变量

变量	必填	描述
UCP_API_KEY	是	作为 Authorization: Bearer 发送
UCP_MERCHANT_ID	否	作为 X-Merchant-Id 标头发送
UCP_SANDBOX	否	设为 true 时，BASE_URL 会切换为 https://sandbox.commerce.googleapis.com/ucp/v1，但会导致 TLS 失败

链接

• Google UCP 公告
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 支付提供治理、预算限制和审计追踪？CodeSpar Enterprise 在这些 MCP 服务的基础上，增加了策略引擎、支付路由和合规模板。

身份验证

服务器会在每个请求中将 UCP_API_KEY 作为 Authorization: Bearer 标头发送，并将 UCP_MERCHANT_ID 作为 X-Merchant-Id 标头发送（src/index.ts:78-83）。

没有用于签发这些凭据的门户。本 README 以前链接的开发者门户 developers.google.com/agents/commerce 返回 HTTP 404。

许可证

MIT