Pepesto MCP 服务器

MCP 服务器，用于 Pepesto API — 让您的智能体能够将任何食谱（URL、纯文本或照片）转换为包含 26 家欧洲超市实时价格的匹配购物篮。该 MCP 涵盖了工作流程中 食谱 → 匹配购物车 的部分（解析 / 搜索 / 将配料映射到 SKU / 检查目录）；下单是单独的步骤 — 请参阅 结账实际发生在哪里。

快速安装

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "pepesto": {
      "command": "npx",
      "args": ["-y", "@pepesto/pepesto-mcp"],
      "env": { "PEPESTO_API_KEY": "pep_sk_…" }
    }
  }
}

Claude Code

claude mcp add pepesto -e PEPESTO_API_KEY=pep_sk_… -- npx -y @pepesto/pepesto-mcp

获取 API 密钥

1. 从按需付费的积分包开始 — 请参阅 https://www.pepesto.com/pricing/。

2. 通过调用 /link 并使用您在结账时使用的电子邮件来生成 API 密钥。该密钥仅返回一次 — 请立即保存。

   curl -X POST https://s.pepesto.com/api/link \
     -H "Content-Type: application/json" \
     -d '{"email":"you@example.com"}'

3. 在您的环境中设置该密钥：

   export PEPESTO_API_KEY=pep_sk_…

工具

该 MCP 在“带有价格的匹配购物车”处停止 — 请参阅 结账实际发生在哪里 以了解用户如何完成订单。/session、/checkout 和 /link 被特意排除在外；请参阅 路线图 了解计划内容。

对话示例

快速：食谱 URL → 匹配购物车

最快的路径。一次工具调用即可返回匹配的购物车和结账链接。

用户： 使用 BBC Good Food 的玛格丽特披萨食谱来构建一个 Tesco 购物车，并添加气泡水和橄榄油。

助手： [使用 pepesto_oneshot，参数为 content_urls、content_text、supermarket_domain: "tesco.com"]

助手： 已在 Tesco 匹配购物车。结账链接：<redirect_url>。

浏览食谱图谱 → 选择 → 匹配购物车

对于“帮我找点吃的”这类提示，智能体首先搜索 Pepesto 的食谱图谱，并返回带有价格的匹配产品。

用户： 帮我找一个两人份的纯素食意大利面食谱。

助手： [使用 pepesto_suggest，参数为 query: "vegan pasta dinner for two"]

助手： 三个选项：奶油腰果通心粉、柠檬蒜香意大利面、烤蔬菜通心粉。您想要哪一个？

用户： 选第一个。在 Coop (coop.ch) 购买。

助手： [使用 pepesto_products，参数为所选食谱的 kg_token 和 supermarket_domain: "coop.ch"]

助手： 在 Coop 匹配了 8 种配料 — 腰果 CHF 4.20，通心粉 CHF 1.95，... — 总计 CHF 18.40。

解析特定食谱 → 匹配购物车

当用户已经有心仪的食谱 URL 或文本时。MCP 返回匹配的产品列表 — 如何处理它由您决定。

用户： 解析这个并列出配料：https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps

助手： [使用 pepesto_parse，参数为 recipe_url]

助手： 4 步轻松制作玛格丽特披萨 — 8 种配料：强力面包粉、速效酵母，...

用户： 现在将它们匹配到 Sainsbury's 的产品。

助手： [使用 pepesto_products，参数为返回的 kg_token 和 supermarket_domain: "sainsburys.co.uk"]

助手： 在 Sainsbury's 匹配了 8 种配料 — 总计 £6.40。

每周膳食计划 → 一个合并的匹配购物车

通过 pepesto_products 在单次调用中处理多个 kg_token — Pepesto 会合并跨食谱的重复配料。

用户： 计划 5 个本周的生酮晚餐，并在 Delhaize 匹配它们。

助手： [使用 pepesto_suggest，参数为 query: "keto dinner low carb high protein", num_to_fetch: 5]

助手： 五个晚餐：牛排配羽衣甘蓝、三文鱼牛油果碗、西葫芦千层面、花椰菜烩饭、鸡肉凯撒沙拉。

用户： 构建一个涵盖整个星期的购物清单。

助手： [使用 pepesto_products，参数为所有五个 kg_tokens 和 supermarket_domain: "delhaize.be"]

助手： 合并匹配：24 种独特配料（部分在食谱间共享），在 Delhaize 估计总计 €68.40。

比较两家超市的价格

对每个市场运行相同的食谱通过 pepesto_products 并比较总价。

用户： 解析这个周日午餐食谱。

助手： [使用 pepesto_parse]

助手： 收到：意大利周日午餐，12 种配料。

用户： 向我展示 Esselunga 和 Conad 的购物车，以便我进行比较。

助手： [使用 pepesto_products 两次 — supermarket_domain: "spesaonline.esselunga.it"，然后是 supermarket_domain: "spesaonline.conad.it"]

助手： Esselunga：€34.20。Conad：€31.50。Conad 便宜 €2.70，主要是在意大利面和番茄上。

用于市场分析的目录转储

仅在明确请求时使用，并积极缓存 — 请参阅下方的 定价与最佳实践。

用户： 我正在构建一个价格比较仪表板。拉取完整的 Plus NL 目录。

助手： 提醒一下 — pepesto_catalog 是这里最昂贵的调用。我只会运行一次；您应该至少缓存结果一天。确认吗？

用户： 是的。

助手： [使用 pepesto_catalog，参数为 supermarket_domain: "plus.nl"]

助手： 目录已转储：23 个类别中的 1,847 个 SKU。

支持的超市

需要此列表中没有的超市？联系 Pepesto。

结账实际发生在哪里

此 MCP 在“带有价格的匹配购物车”处停止。它不会自动在超市网站上下单。完成购物有两种方式：

• Pepesto 应用（推荐）。 在浏览器中打开 pepesto_oneshot 返回的 redirect_url，或者将 pepesto_products 中的匹配产品列表交给用户，让他们在 Pepesto 应用 中重新创建 — 那里有托管的结账流程，包括登录、购物篮审查和（部分市场）支付。

• 超市自己的网站。 用户可以获取 pepesto_products 中的匹配产品列表，并直接在 tesco.com / coop.ch 等网站上添加 SKU。速度较慢，但不需要 Pepesto 账户。

定价与最佳实践

Pepesto 采用简单的按需付费积分制 — 您只需为您智能体实际使用的内容付费，且积分永不过期，因此充值后归您所有，直到用完为止。我们还为学生和早期团队提供折扣，如果是这种情况，请打个招呼。完整的单次调用定价和批量等级请访问 https://www.pepesto.com/pricing/。

充分利用每一点积分的几个小贴士：

• pepesto_credits 是免费的 — 随时调用以快速读取余额。

• pepesto_oneshot、pepesto_parse、pepesto_suggest 和 pepesto_products 是日常调用（匹配食谱、计划一周、比较购物篮），定价适合日常智能体使用。

• pepesto_catalog 会对超市进行完整的 SKU 转储，是负担最重的调用。它是进行真实市场分析或价格比较仪表板的正确工具 — 只需为每个超市至少缓存结果一天。不确定是否需要它？告诉我们您的用例，我们通常会为您指出更便宜的路径。

路线图

计划跟进：

• pepesto_session — 封装 /session，以便智能体可以从选定的 SKU 构建 Pepesto 端的结账会话。

• pepesto_checkout — 封装 /checkout，即驱动超市自身网站（登录、添加到购物篮、提示输入验证码等）的逐步浏览器自动化循环。这是实现完全自主购物缺失的一环。

• 托管结账移交 — 将 Pepesto 应用深度链接作为结构化工具结果呈现（而不是纯文本），以便 MCP 客户端可以将其渲染为按钮而不是 URL。

如果其中任何一项能为您解除阻塞，请告诉我们 — 这将使它们在队列中提前。

开发

git clone https://github.com/pepesto-solutions/pepesto-mcp.git
cd pepesto-mcp
npm install
npm run build
npm test
npm run test:coverage

针对本地构建运行检查器：

PEPESTO_API_KEY=pep_sk_… npm run inspector

许可证

本仓库中的 Pepesto MCP 服务器根据 MIT 许可证 授权。