Pepesto MCP Server

Pepesto MCP サーバー

Pepesto API 用の MCP サーバーです。レシピ（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 → 商品を対応付けたカート

最短の方法です。ツールを1回呼び出すだけで、商品を対応付けたカートとチェックアウトリンクが返されます。

ユーザー： BBC Good Food のマルゲリータピザのレシピを使って Tesco のカートを作り、炭酸水とオリーブオイルも追加してください。

アシスタント： [content_urls、content_text、supermarket_domain: "tesco.com" を指定して pepesto_oneshot を使用]

アシスタント： Tesco のカートを作成しました。チェックアウトリンク：<redirect_url>。

無料の遅延引き継ぎ → 料金はエンドユーザーが負担（pepesto_predirect）

API クライアントが商品マッチングの料金を負担したくなく、遅延ディープリンクで問題ない場合に使います。pepesto_predirect は無料で、API キーは不要です。リンクを即座に返し、解析と商品マッチングは、ユーザーがリンクを開いたときに実行されます。ユーザーが Pepesto アプリで決済に進むと、料金が発生します（アプリがインストールされていない場合は、最初にアプリストアへ移動します。リストは保持されます）。

対象ユーザー： pepesto_predirect はエンドユーザー／エージェント向けのツールであり、開発者向けのインテグレーション用エンドポイントではありません。アシスタント（Claude Desktop、ChatGPT など）とチャットしている人が、買い物リストを自分のスマートフォンに引き継ぎたい場合に適しています。エージェントがリンクを返し、ユーザーはアプリで手続きを完了して料金を支払います。Pepesto を基盤に製品を開発する場合は、通常、代わりに pepesto_oneshot（マッチング済みのカートを事前に作成し、料金はクライアントが負担）が適しています。それでも predirect を使う開発者向けの用途がありますか？お問い合わせください — ぜひお聞かせください。

料金をエンドユーザーが負担する場合は pepesto_predirect を使います。クライアントが事前に（価格付きで）バスケットをマッチングし、その料金を負担する場合は pepesto_oneshot を使います。

ユーザー： 毎週の買い物リストです。スマートフォンで開いて Pepesto アプリで手続きを完了できるリンクだけください。

アシスタント： [shopping_list: "2 avocados\n1 loaf of bread\n500 g tomatoes\n..." を指定して pepesto_predirect を使用]

アシスタント： 完了しました — 🛒 Pepesto で買い物リストを開く → 開くのは無料です · 3 品目の準備ができました · アプリでの決済時にのみ料金が発生します。スマートフォンで開いてください（コンピューターでは、スキャン用の QR コードが表示されます）。

このツールは、そのまま表示できる Markdown として結果を返します。タップ可能なラベル付きリンクと短い説明文が含まれるため、長い redirect_url が生のテキストとして表示されることはありません。

レシピグラフを検索 → 選択 → マッチング済みカート

「料理するものを探して」というプロンプト向けです。エージェントがまず Pepesto のレシピグラフを検索し、価格付きのマッチング済み商品を返します。

ユーザー： 2 人分のヴィーガンパスタのレシピを探してください。

アシスタント： [query: "vegan pasta dinner for two" を指定して pepesto_suggest を使用]

アシスタント： 候補は 3 つあります。クリーミーカシューナッツペンネ、レモンガーリックスパゲッティ、ロースト野菜のリガトーニです。どれにしますか？

ユーザー： 最初のものにします。Coop（coop.ch）で買い物してください。

アシスタント： 選んだレシピの kg_token と supermarket_domain: "coop.ch" を指定して pepesto_products を使用]

アシスタント： Coop で 8 品目の食材をマッチングしました — カシューナッツ CHF 4.20、ペンネ CHF 1.95、... — 合計 CHF 18.40。

特定のレシピを解析 → マッチング済みカート

ユーザーがすでにレシピの URL やテキストを指定している場合に使います。MCP はマッチング済みの商品リストを返します。その後の使い方は自由です。

ユーザー： これを解析して、食材を取り出してください：https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps

アシスタント： recipe_url を指定して pepesto_parse を使用]

アシスタント： 4 ステップのマルゲリータピザ — 食材 8 品目：強力粉、速効性イースト、...

ユーザー： では、これらを Sainsbury's の商品にマッチングしてください。

アシスタント： 返された kg_token と supermarket_domain: "sainsburys.co.uk" を指定して pepesto_products を使用]

アシスタント： Sainsbury's で 8 品目の食材をマッチングしました — 合計 £6.40。

週間の献立 → 1つにまとめたマッチ済みカート

1回の呼び出しで複数のkg_tokenをpepesto_productsに渡すと、Pepestoがレシピ間で重複する食材をまとめます。

ユーザー： 今週のケトディナーを5品考えて、Delhaizeで商品をマッチングしてください。

アシスタント： [query: "keto dinner low carb high protein", num_to_fetch: 5を指定してpepesto_suggestを使用]

アシスタント： ディナーを5品ご提案します：ステーキ＆ケール、サーモンとアボカドのボウル、ズッキーニのラザニア、カリフラワーのリゾット、チキンシーザー。

ユーザー： 1週間分をまとめた買い物リストを作ってください。

アシスタント： [5つすべてのkg_tokensとsupermarket_domain: "delhaize.be"を指定してpepesto_productsを使用]

アシスタント： マッチ結果をまとめました：重複を除いた食材は24品（レシピ間で共通する食材を含む）で、Delhaizeでの合計見積もりは€68.40です。

2つのスーパーマーケットの価格を比較

同じレシピに対して各店舗ごとにpepesto_productsを実行し、合計金額を比較します。

ユーザー： この日曜日のランチのレシピを解析してください。

アシスタント： [pepesto_parseを使用]

アシスタント： 承知しました：イタリアの日曜日のランチで、食材は12品です。

ユーザー： 比較できるように、EsselungaとConadの両方でカートを表示してください。

アシスタント： [pepesto_productsを2回使用 — まずsupermarket_domain: "spesaonline.esselunga.it"、次にsupermarket_domain: "spesaonline.conad.it"を指定]

アシスタント： Esselunga：€34.20。Conad：€31.50。Conadのほうが€2.70安く、主な差はパスタとトマトです。

市場分析用の商品カタログの一括取得

明示的に依頼された場合に限って実行し、積極的にキャッシュしてください。詳しくは下記の料金とベストプラクティスをご覧ください。

ユーザー： 価格比較ダッシュボードを作成しています。Plus NLの全カタログを取得してください。

アシスタント： ご注意ください。pepesto_catalogはここで最も高額な呼び出しです。実行は1回だけにし、結果は少なくとも1日キャッシュすることをおすすめします。よろしいですか？

ユーザー： はい。

アシスタント： [supermarket_domain: "plus.nl"を指定してpepesto_catalogを使用]

アシスタント： カタログを取得しました：23カテゴリにわたる1,847 SKUです。

対応スーパーマーケット

#	国	スーパーマーケット	ドメイン / 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が対応するのは「価格付きのマッチ済みカート」までです。スーパーマーケットのウェブサイトで注文を完了する操作は自動化しません。購入を完了する方法は2つあります。

• Pepestoアプリ（おすすめ）。 ブラウザーでpepesto_oneshotが返すredirect_urlを開くか、pepesto_productsのマッチ済み商品リストをユーザーに渡し、Pepestoアプリで商品を再度カートに追加するよう案内してください。ログイン、カートの確認、（一部の市場では）支払いを含むホスト型の購入手続きは、こちらで行えます。
• スーパーマーケットの公式サイト。 ユーザーはpepesto_productsのマッチ済み商品リストを使って、商品SKUをtesco.com / coop.chなどで直接カートに追加できます。手間はかかりますが、Pepestoアカウントは必要ありません。

料金とベストプラクティス

Pepesto はシンプルな従量課金制のクレジットで利用できます。エージェントが実際に使用した分だけお支払いいただき、クレジットに有効期限はありません。チャージしたクレジットは使い切るまでご利用いただけます。また、学生や創業初期のチーム向けの割引もご用意しています。該当する場合は、お気軽にお問い合わせください。1 回あたりの料金と利用量に応じた料金プランの詳細は、https://www.pepesto.com/pricing/をご覧ください。

クレジットを最大限に活用するためのヒントをいくつかご紹介します。

• pepesto_credits は無料です。いつでも呼び出して、残高をすばやく確認できます。
• pepesto_predirect は無料で、API キーも不要です。マッチングを後回しにして、チェックアウト時にエンドユーザーに課金するため、API クライアントには費用がかかりません。
• pepesto_oneshot、pepesto_parse、pepesto_suggest、pepesto_products は、日常的に使う呼び出しです（レシピの照合、1 週間の献立の計画、買い物かごの比較など）。エージェントでの通常利用に適した料金設定です。
• pepesto_catalog は、スーパーマーケットの商品 SKU 全件を取得するため、最も負荷の高い呼び出しです。本格的な市場分析や価格比較ダッシュボードには適していますが、結果はスーパーマーケットごとに少なくとも 1 日キャッシュしてください。必要かどうかわからない場合は、ユースケースをお聞かせください。通常は、より安価な方法をご案内します。

ロードマップ

今後、以下を予定しています。

• pepesto_session — /session をラップし、エージェントが選択した SKU から Pepesto 側のチェックアウトセッションを作成できるようにします。
• pepesto_checkout — /checkout をラップします。スーパーマーケット独自のサイトで、ログイン、買い物かごへの追加、CAPTCHA の入力要求などを行う、1 ステップずつ進むブラウザー自動化ループです。完全自律型のショッピングを実現するために欠けている機能です。
• ホスト型チェックアウトへの引き継ぎ — 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 License の下でライセンスされています。

デプロイ

• Glama に Pepesto MCP をデプロイする。