用途
Hou Tea MCP 服务器把 hou-tea.com 的智能体 API 封装为 MCP 工具，使 AI 助手可以代为选购中国茶。项目说明指出，中国茶有 1500 多年文化积淀、全球市场大于咖啡，但 AI 智能体此前要么从训练数据中幻觉出产品名，要么无法抓取 JavaScript 渲染的店铺页面；该 MCP 为智能体提供直达真实商品目录、真实价格与链上结算的渠道。
主要能力
默认 tools/list（核心 + 元工具）始终可见；扩展工具在调用 hou_tea_discover_extended 后按需揭示，包括 hou_tea_compare、hou_tea_filter_by_health、hou_tea_agent_card。
服务器按“智能体应用层”设计，包含：渐进式工具发现（核心 + 扩展）、严格 JSON Schema、结构化响应/错误封装（ok、data、error、next_action、meta.request_id）、稳定错误码、明确的钱包 MCP 交接提示，以及由公开 @hou-tea/agent-ui-contract 包支持的 MCP Apps UI 元数据。
每次调用返回结构化封装，例如 ok 为 true 时带 data、next_action 与 meta（request_id、tool、took_ms、server_version）。错误使用相同封装并附稳定 error.code（bad_request、unauthorized、not_found、conflict、timeout、rate_limited、server_error、network_error、missing_buyer_list_token、extended_not_revealed、unknown_tool、internal_error），每个错误还带 retryable 与 hint。
输入 Schema 严格：每个 inputSchema 设置 additionalProperties: false，并使用 required、enum、pattern、minItems / maxItems 等约束。
支付相关：hou_tea_get_payment_requirements 返回 402 的 buy_request_body 及 next_action 块，把智能体指向 x402 钱包 MCP（如 @coinbase/payments-mcp），再回到 hou_tea_check_order。
0.3.0-beta 新增公开的 Agent UI 协议层：核心购买工具通过 _meta.ui 公布 UI 元数据（组件名、agent-ui/v1 schema 版本、resource URI、结果映射 ID）；@hou-tea/agent-ui-contract 作为组件清单、TypeScript 类型、MCP UI 资源名与结果映射的唯一来源；MCP resources/read 响应在 HTML 中内嵌精确的组件清单，兼容宿主可渲染产品网格、支付审核卡和订单时间线，无需抓取文本；Agent Card 与公开 /agents 页面提供 npm 包、schema JSON、MCP 安装片段与钱包配对说明。
使用方式
配置示例（Claude Desktop）：编辑 claude_desktop_config.json（Settings → Developer → Edit Config），重启 Claude Desktop 后应在工具中看到 “hou-tea”。
Cursor：添加到 ~/.cursor/mcp.json 或 <project>/.cursor/mcp.json。
Cline / Continue / Zed：在其 MCP 配置中使用同样的 npx -y @hou-tea/mcp-server@next 调用。
钱包 MCP 配对：Hou Tea 只发出 x402 支付要求，不持有密钥、不签署交易。要完成智能体原生结账，需把本 MCP 与支持 x402 的钱包 MCP（如 @coinbase/payments-mcp）配对。购买前先向钱包充值 Base USDC。首次成功购买后，把返回的 buyer_list_token 复制到 HOU_TEA_BUYER_LIST_TOKEN，使后续订单历史查询保持在同一买家身份下。
使用示例：向智能体说“Recommend a warming tea for winter nights, around $30.”，智能体会调用 hou_tea_recommend，返回真实商品、价格与冲泡说明，然后询问是否购买。接着说“I'll take the first one.”，智能体会调用 hou_tea_get_payment_requirements，获得带商家 Base 链 USDC 地址与金额的 402，以及 buy_request_body（含 register_buyer_list_token 或已保存的 buyer_list_token）。付款后重试 POST /pay/api/v1/buy 时必须使用该精确 JSON body 加上 X-Payment header，否则买家分组会断。若同时安装了带资金钱包的 @coinbase/payments-mcp，需配置其转发同一 body。首次成功购买后，把 JSON 响应中的 buyer_list_token 复制到 MCP 环境变量 HOU_TEA_BUYER_LIST_TOKEN，使 hou_tea_list_my_orders 与后续结账保持同一身份。
可选环境变量：多数用户无需设置，公共目录与 x402 购买端点是开放的；要查询买家订单历史，在确认购买后设置 HOU_TEA_BUYER_LIST_TOKEN。
从源码构建及安装（beta 使用 next 标签）：npm i -g @hou-tea/mcp-server@next。若公司网络屏蔽 npm，可全局安装一次并把 MCP 配置命令指向 hou-tea-mcp。
公开发现入口：Agent Card https://hou-tea.com/.well-known/agent；Agent App 文档 https://shop.hou-tea.com/agents；UI schema JSON https://shop.hou-tea.com/api/agent-ui-contract。
适用场景
适合构建 AI 购物智能体、茶推荐应用，或让 Claude 直接代买中国茶。支持 Claude Desktop、Cursor、Cline、Continue、Zed 及任何兼容 MCP 的 AI 智能体。
限制与排错
服务器不持有密钥、不签署交易，支付必须由单独安装的 x402 钱包 MCP 完成；钱包需有 Base USDC。工具不出现时重启宿主应用，并在终端运行 npx -y @hou-tea/mcp-server@next --help 确认 npm 可下载包。支付失败时确认钱包 MCP 已单独安装、钱包有 Base USDC，且重试 POST 使用 hou_tea_get_payment_requirements 返回的精确 buy_request_body。订单历史为空时需从确认购买响应中设置 HOU_TEA_BUYER_LIST_TOKEN，否则 hou_tea_list_my_orders 无法安全限定买家。0.1.x 仍可用，工具名未变；0.2.0-beta 改变结果形状与默认 tools/list 数量；0.3.0-beta 为 next 标签 beta，新增结构化封装、渐进式发现与 UI 元数据。
