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キーの取得

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 → マッチング済みカート

最速のパスです。1回のツール呼び出しで、マッチング済みカートとチェックアウトリンクが返されます。

ユーザー: BBC Good Foodのピザ・マルゲリータのレシピを使ってTescoのカートを作成し、さらに炭酸水とオリーブオイルを追加して。

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

アシスタント: Tescoでカートがマッチングされました。チェックアウトリンク: <redirect_url>

レシピグラフの閲覧 → 選択 → マッチング済みカート

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

ユーザー: 2人用のヴィーガンパスタのレシピを探して。

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

アシスタント: 3つの選択肢があります：Creamy Cashew Penne、Lemon Garlic Spaghetti、Roasted Veg Rigatoni。どれにしますか？

ユーザー: 最初のやつで。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 を使用]

アシスタント: Pizza Margherita in 4 easy steps — 8つの材料：強力粉、インスタントドライイースト、...

ユーザー: それらをSainsbury'sの商品とマッチングして。

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

アシスタント: Sainsbury'sで8つの材料がマッチングされました — 合計 £6.40。

週間の献立 → 1つの統合されたマッチング済みカート

pepesto_products を通じて複数の kg_token を一度に呼び出すと、Pepestoがレシピ間で重複する材料を統合します。

ユーザー: 今週のケトディナーを5つ計画して、Delhaizeでマッチングして。

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

アシスタント: 5つのディナー：Steak & Kale、Salmon Avocado Bowl、Zucchini Lasagna、Cauliflower Risotto、Chicken Caesar。

ユーザー: 1週間分をカバーする買い物リストを1つ作って。

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

アシスタント: 統合マッチング：24種類のユニークな材料（レシピ間で共有されているものあり）、Delhaizeでの合計見積もり €68.40。

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

同じレシピを各マーケットで pepesto_products にかけ、合計を比較します。

ユーザー: この日曜ランチのレシピを解析して。

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

アシスタント: 了解：Italian Sunday Lunch、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。

対応スーパーマーケット

リストにないスーパーマーケットが必要ですか？Pepestoまでご連絡ください。

チェックアウトの仕組み

このMCPは「価格付きマッチング済みカート」までを対象としています。スーパーマーケットのウェブサイトでの注文確定を自動化するものではありません。完了までの2つの方法：

• 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をダンプするため、最も負荷の高い呼び出しです。市場分析や価格比較ダッシュボードには最適ですが、スーパーマーケットごとに少なくとも1日は結果をキャッシュしてください。必要かどうかわからない場合は、ユースケースをお知らせください。より安価な方法をご案内します。

ロードマップ

以下を予定しています：

• pepesto_session — /session をラップし、エージェントが選択した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ライセンス の下でライセンスされています。