Pepesto MCP Server

Pepesto MCP 服务

面向 Pepesto API 的 MCP 服务——让你的 Agent 能够将任何食谱（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 密钥

大多数工具需要密钥，但 pepesto_predirect 是公开且免费的——无需密钥即可使用（最终用户在应用中结账时付款）。

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":"[email protected]"}'
   

3. 在环境中设置密钥：

   export PEPESTO_API_KEY=pep_sk_…
   

工具

工具	端点	描述
pepesto_oneshot	POST /oneshot	一步生成匹配的购物车，包含用于结账的 redirect_url。
pepesto_predirect	POST /predirect	免费，无需 API 密钥。 将购物清单转换为延迟深层链接（redirect_url）；最终用户在 Pepesto 应用中结账时付款。
pepesto_parse	POST /parse	将 URL / 文本 / 图片食谱解析为结构化食材和 KgToken。
pepesto_suggest	POST /suggest	搜索 Pepesto 中超过 100 万个食谱构成的图谱。
pepesto_products	POST /products	将 KgToken 和超市映射为具体商品及价格。
pepesto_catalog	POST /catalog	超市的完整 SKU 清单。仅在明确请求时使用；请缓存结果。
pepesto_credits	POST /credits	查看剩余点数。免费。

MCP 的功能止于“带价格的匹配购物车”——请参阅结账实际发生的位置，了解用户如何完成订单。/session、/checkout 和 /link 有意不封装；计划内容请参阅路线图。

对话示例

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

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

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

助手： [使用 pepesto_oneshot，并设置 content_urls、content_text、supermarket_domain: "tesco.com"]

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

免费、延后跳转 → 由最终用户付费（pepesto_predirect）

当 API 客户端不想为匹配付费，且可以接受延后打开的深层链接时，使用此功能。pepesto_predirect 免费，无需 API 密钥：它会立即返回一个链接，解析和商品匹配则会延后到用户打开链接时才进行。用户继续在 Pepesto 应用中结账时才会付费（如果尚未安装该应用，系统会先将用户送往应用商店，并保留清单）。

适用对象：pepesto_predirect 是面向最终用户 / Agent 的工具，而非开发者集成接口。如果有人正在与助手（Claude Desktop、ChatGPT 等）聊天，并想把购物清单发送到自己的手机上，这个工具就很合适——Agent 返回一个链接，用户在应用中完成操作（并付费）。如果你是基于 Pepesto 构建产品的开发者，通常应使用 pepesto_oneshot（预先匹配购物车，由你付费）。不过，如果你确实有面向开发者的 predirect 使用场景，告诉我们——我们很乐意了解。

如果费用应由最终用户承担，请使用 pepesto_predirect；如果客户端希望预先匹配购物篮（含价格）并愿意为此付费，请使用 pepesto_oneshot。

**用户：**这是我每周的购物清单——给我一个链接，我可以在手机上打开，然后在 Pepesto 应用中完成操作。

助手： [使用 pepesto_predirect，传入 shopping_list: "2 avocados\n1 loaf of bread\n500 g tomatoes\n..."]

助手：完成了——🛒 在 Pepesto 中打开你的购物清单 → 免费打开 · 3 件商品已就绪 · 你只需在应用中结账时付费。在手机上打开（如果使用电脑，会显示一个可扫描的二维码）。

工具会以可直接展示的 Markdown 格式返回内容——一个可点击的带标签链接，以及一段简短说明——因此不会直接显示冗长的 redirect_url。

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

适用于“给我找点东西做”这类提示词：Agent 会先搜索 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。

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

适用于用户已经有心仪食谱网址或文本的情况。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"]

助手： 已导出目录：共 1,847 个 SKU，分属 23 个类别。

支持的超市

#	国家/地区	超市	域名 / ID
2	🇬🇧 GB	Sainsbury's	sainsburys.co.uk
3	🇬🇧 GB	ASDA	asda.com
4	🇬🇧 GB	Morrisons	groceries.morrisons.com
5	🇬🇧 GB	Waitrose	waitrose.com
1	🇬🇧 GB	Tesco	tesco.com
6	🇳🇱 NL	Albert Heijn	ah.nl
7	🇳🇱 NL	Jumbo	jumbo.com
8	🇳🇱 NL	Plus NL	plus.nl
9	🇩🇪 DE	Rewe	shop.rewe.de
10	🇨🇭 CH	Coop CH	coop.ch
11	🇨🇭 CH	Migros	migros.ch
12	🇨🇭 CH	Farmy	farmy.ch
13	🇨🇭 CH	Aldi CH	aldi-now.ch
14	🇧🇪 BE	Colruyt	colruyt.be
15	🇧🇪 BE	Delhaize	delhaize.be
16	🇮🇪 IE	Tesco IE	tesco.ie
17	🇮🇪 IE	SuperValu	shop.supervalu.ie
18	🇮🇪 IE	Dunnes	dunnesstoresgrocery.com
19	🇮🇹 IT	Esselunga	spesaonline.esselunga.it
20	🇮🇹 IT	Conad	spesaonline.conad.it
21	🇩🇰 DK	Nemlig	nemlig.com
22	🇳🇴 NO	Meny	meny.no
23	🇵🇱 PL	Frisco	frisco.pl
24	🇵🇱 PL	Auchan PL	zakupy.auchan.pl
25	🇧🇬 BG	Bulmag	bulmag.org
26	🇧🇬 BG	eBag	ebag.bg

需要查询不在列表中的超市？联系 Pepesto。

实际在哪里完成结账

此 MCP 服务只会生成“已匹配商品并显示价格的购物车”。它不会自动在超市网站上提交订单。可通过以下两种方式完成购物：

• Pepesto 应用（推荐）。 在浏览器中打开 pepesto_oneshot 返回的 redirect_url，或者将 pepesto_products 返回的匹配商品清单交给用户，并告诉他们在 Pepesto 应用中重新创建购物车 — 托管式结账流程就在这里，其中包括登录、检查购物篮，以及（在部分市场）付款。
• 超市自有网站。 用户可以使用 pepesto_products 返回的匹配商品清单，直接在 tesco.com / coop.ch / 等网站上添加 SKU。速度较慢，但无需 Pepesto 账户。

定价与最佳实践

Pepesto 采用简单的按使用量付费积分制——你只需为 Agent 实际使用的部分付费，而且积分永不过期，因此充值后，积分会一直属于你，直到用完。我们还为学生和初创团队提供折扣，如果你符合条件，请打个招呼。每次调用的完整定价和用量阶梯请见 https://www.pepesto.com/pricing/.

以下建议可帮助你充分利用每一笔积分：

• pepesto_credits 免费——可随时调用，快速查看余额。
• pepesto_predirect 免费且无需 API 密钥——它会推迟匹配，并在结账时向最终用户收费，因此 API 客户端无需付费。
• pepesto_oneshot、pepesto_parse、pepesto_suggest 和 pepesto_products 是日常调用（匹配食谱、规划一周饮食、比较购物篮），定价适合 Agent 日常使用。
• pepesto_catalog 会完整导出一家超市的 SKU，是最耗费资源的调用。它适用于真正的市场分析或价格比较仪表板——只需为每家超市至少缓存一天结果。不确定是否需要它？告诉我们你的使用场景，我们通常会为你推荐更省钱的方案。

路线图

计划推出：

• pepesto_session — 封装 /session，让 Agent 能根据选定的 SKU 创建 Pepesto 端的结账会话。
• pepesto_checkout — 封装 /checkout，这是驱动超市自有网站的逐步浏览器自动化循环（登录、加入购物篮、提示输入 CAPTCHA 等）。这是实现完全自主购物所缺少的环节。
• 托管结账交接 — 将 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 许可证。

部署

• 在 Glama 上部署 Pepesto MCP。