라미 레비 MCP 서버

Rami Levy 온라인 식료품점 API용 MCP 서버입니다. 이는 Rami Levy의 전자상거래 플랫폼을 MCP 지원 LLM과 통합하는 방법을 보여주는 개념 증명 구현입니다.

도구

1. search_items

   • Rami Levy의 카탈로그에서 제품 검색

   • 입력:

     • q (문자열): 검색어

     • store (문자열, 선택 사항): 매장 식별자(기본값: "331")

     • aggs (숫자, 선택 사항): 집계 플래그(기본값: 1)

   • 반환: 이름, 가격, 이미지 URL 및 ID가 포함된 제품 배열

2. add_to_cart

   • 쇼핑 카트에 하나 이상의 품목을 추가하세요

   • 입력:

     • store (문자열): 매장 식별자(예: "331")

     • items (배열): 추가할 항목 목록, 각 항목에는 다음이 포함됩니다.

       • id (숫자): 제품 식별자

       • quantity (숫자): 추가할 수량 (최소: 1)

   • 반품: 가격 및 할인이 포함된 장바구니 내용이 업데이트되었습니다.

3. remove_from_cart

   • 보관할 항목의 업데이트된 목록을 제공하여 장바구니에서 항목을 제거합니다.

   • 입력:

     • store (문자열): 매장 식별자

     • items (배열): 장바구니에 보관할 항목의 업데이트된 목록

   • 반품: 장바구니 내용이 업데이트되었습니다.

4. update_quantity

   • 장바구니에 있는 품목의 수량을 업데이트합니다.

   • 입력:

     • store (문자열): 매장 식별자

     • id (숫자): 제품 식별자

     • newQuantity (숫자): 제품의 새로운 수량(최소: 1)

   • 반품: 장바구니 내용이 업데이트되었습니다.

Related MCP server: Merge MCP Server

자원

1. rami-levy://checkout

   • Rami Levy 결제 페이지의 URL을 받으세요

   • 반품: 결제 페이지 URL

설정

입증

이 MCP 서버에는 활성 Rami Levy 세션의 인증 토큰이 필요합니다. 토큰을 얻으려면 다음을 수행하세요.

1. 라미 레비 웹사이트 에 로그인하세요

2. 브라우저의 개발자 도구(F12)를 엽니다.

3. 네트워크 탭으로 이동

4. 요청하기(예: 제품 검색)

5. 요청 헤더에서 다음을 추출합니다.

   • RAMI_LEVY_API_KEY : Authorization 헤더의 "Bearer" 뒤에 있는 토큰

   • ECOM_TOKEN : 전체 ecomtoken 헤더 값

   • COOKIE : 전체 쿠키 헤더 값

환경 변수

다음 변수를 사용하여 .env 파일을 만듭니다.

지엑스피1

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

개발

1. 종속성 설치:

2. 프로젝트를 빌드하세요:

3. 서버를 시작합니다:

보안 고려 사항

⚠️ 중요 : 이는 개념 증명 구현입니다. 참고:

1. 인증 토큰은 Rami Levy 계정에 대한 전체 액세스를 제공합니다.

2. 토큰은 안전하게 보관되어야 하며 버전 제어에 절대 위탁되어서는 안 됩니다.

3. 토큰은 주기적으로 만료되므로 새로 고쳐야 합니다.

4. 이 구현은 적절한 보안 검토 없이 프로덕션 용도로 의도된 것이 아닙니다.

제한 사항

1. 세션 토큰이 만료되어 수동으로 새로 고쳐야 합니다.

2. Rami Levy API의 일부 기능은 구현되지 않았습니다(예: 사용자 프로필, 주문 내역)

3. 만료된 세션에 대한 오류 처리가 개선될 수 있습니다.

4. 속도 제한 구현 없음

기여하다

이슈 및 풀 리퀘스트는 환영합니다! 인증 토큰과 같은 민감한 정보는 커밋하지 않도록 주의해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

부인 성명

본 프로젝트는 비공식 프로젝트이며 Rami Levy Chain Stores Ltd.와 제휴 관계가 아니며, Rami Levy Chain Stores Ltd.의 보증도 받지 않았습니다. 모든 제품명, 로고, 브랜드는 해당 소유자의 자산입니다.