用途
SommelierX mcp-server 是面向 AI 助手的葡萄酒配餐 MCP（Model Context Protocol）服务器，用于把侍酒师级配餐能力接入 Claude、Cursor、Windsurf 或其他兼容 MCP 的客户端。连接后，用户可以直接向 AI 助手提出配餐问题，例如“烧烤三文鱼配什么酒？”，助手会调用该服务器获取推荐。
主要能力
服务器由 SommelierX Wine DNA 算法驱动，该算法基于 17 个食物 DNA 维度与 19 个葡萄酒 DNA 维度计算匹配。资料提及的主要能力包括：
- 配餐：将葡萄酒与食材、菜肴匹配；
- 反向配餐：给定酒款，推荐适合烹饪的菜肴；
- 食谱链接配餐：根据食谱 URL 给出配餐建议；
- 多道菜配餐：例如为包含凯撒沙拉、羊排和巧克力慕斯的整套菜单推荐一款通用酒；
- Pro API Key 还支持食谱提取、分组配餐和评分明细。 当使用 pair_wine_with_ingredients 时，服务器会自动把自然语言食材名称解析为数据库条目，AI 助手无需知道数据库 ID，直接传入食材名称即可。
使用方式
在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加配置即可；Cursor、Windsurf 及其他 MCP 客户端使用相同配置，将 command 与 args 加入客户端的 MCP 设置。配置完成后，向 AI 助手提问，助手会调用相应的 SommelierX 工具，MCP 服务器将输入转换为结构化 API 调用，返回带评分的葡萄酒推荐。
认证支持两种方式，任选其一即可，无需同时配置：
- API Key（订阅）：在 MCP 客户端配置中设置环境变量 SOMMELIERX_API_KEY，密钥格式为 sk_live_...，按套餐（Free / Pro / Enterprise）获得每月调用额度。可在 api.sommelierx.com 获取 API Key。
- x402 支付（按次付费）：无需 API Key，AI 代理通过 Coinbase x402 协议使用 Base 网络上的 USDC 按次支付。请求缺少 API Key 时，服务器返回 402 Payment Required 响应及支付负载，兼容 x402 的代理会自动处理。适用于自行管理钱包的 AI 代理、无需订阅的按需付费以及代理间商务（无需人工介入）等场景。
使用 API Key 时，调用从套餐额度中扣除；使用 x402 时，每次调用按标价收费。
适用场景
- 普通用户向 AI 助手询问日常配餐；
- 规划多道菜晚宴并寻找通用酒款；
- 已知酒款反推可烹饪的菜肴；
- 根据在线食谱 URL 获取配餐建议；
- AI 代理自动管理钱包、按次付费的代理间商务。
限制
需要 Node.js >= 18.0.0。Pro API Key 才支持食谱提取、分组配餐和评分明细等功能。x402 需要兼容该协议的代理来处理 402 支付响应。完整 API 文档位于 docs.sommelierx.com，OpenAPI 规范位于 https://api.sommelierx.com/api/v1/openapi.json。资料未提供具体价格数值、各套餐额度及算法评分细节。
