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 → 장바구니 매칭

가장 빠른 경로입니다. 도구 호출 한 번으로 장바구니 매칭과 결제 링크를 반환합니다.

사용자: 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 사용]

어시스턴트: 세 가지 옵션이 있습니다: 크리미 캐슈 펜네, 레몬 갈릭 스파게티, 구운 채소 리가토니. 어떤 것을 원하시나요?

사용자: 첫 번째 걸로 할게. 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.

주간 식단 계획 → 하나의 통합 장바구니

pepesto_products를 통해 여러 kg_token을 한 번에 호출하면 Pepesto가 레시피 간 중복 재료를 병합합니다.

사용자: 이번 주 5일치 키토 저녁 식단을 계획하고 Delhaize에서 매칭해 줘.

어시스턴트: [query: "keto dinner low carb high protein", num_to_fetch: 5와 함께 pepesto_suggest 사용]

어시스턴트: 다섯 가지 저녁 식단: 스테이크 & 케일, 연어 아보카도 볼, 주키니 라자냐, 콜리플라워 리조또, 치킨 시저.

사용자: 일주일 전체를 아우르는 하나의 쇼핑 리스트를 만들어 줘.

어시스턴트: [5개의 kg_tokens와 supermarket_domain: "delhaize.be"를 사용하여 pepesto_products 사용]

어시스턴트: 통합 매칭: 24개의 고유 재료(일부 레시피 간 공유), Delhaize 예상 총액 €68.40.

두 슈퍼마켓 간 가격 비교

각 마켓에 대해 pepesto_products를 통해 동일한 레시피를 실행하고 합계를 비교합니다.

사용자: 이 일요일 점심 레시피를 파싱해 줘.

어시스턴트: [pepesto_parse 사용]

어시스턴트: 확인했습니다: 이탈리안 일요일 점심, 12개 재료.

사용자: Esselunga와 Conad의 장바구니를 모두 보여줘서 비교할 수 있게 해 줘.

어시스턴트: [supermarket_domain: "spesaonline.esselunga.it"와 supermarket_domain: "spesaonline.conad.it"로 pepesto_products를 두 번 사용]

어시스턴트: Esselunga: €34.20. Conad: €31.50. Conad가 €2.70 더 저렴하며, 주로 파스타와 토마토에서 차이가 납니다.

시장 분석을 위한 카탈로그 덤프

명시적인 요청이 있을 때만 사용하며, 적극적으로 캐싱하세요 — 아래 가격 및 모범 사례를 참조하세요.

사용자: 가격 비교 대시보드를 만들고 있어. Plus NL 전체 카탈로그를 가져와 줘.

어시스턴트: 주의하세요 — pepesto_catalog는 여기서 가장 비용이 많이 드는 호출입니다. 한 번만 실행할 예정이니, 결과를 최소 하루 동안 캐싱해야 합니다. 진행할까요?

사용자: 응.

어시스턴트: [supermarket_domain: "plus.nl"와 함께 pepesto_catalog 사용]

어시스턴트: 카탈로그 덤프 완료: 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을 래핑합니다(로그인, 장바구니 추가, 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 라이선스에 따라 라이선스가 부여됩니다.