라미 레비 MCP 서버

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

도구

search_items
- Rami Levy의 카탈로그에서 제품 검색
- 입력:
  - q (문자열): 검색어
  - store (문자열, 선택 사항): 매장 식별자(기본값: "331")
  - aggs (숫자, 선택 사항): 집계 플래그(기본값: 1)
- 반환: 이름, 가격, 이미지 URL 및 ID가 포함된 제품 배열
add_to_cart
- 쇼핑 카트에 하나 이상의 품목을 추가하세요
- 입력:
  - store (문자열): 매장 식별자(예: "331")
  - items (배열): 추가할 항목 목록, 각 항목에는 다음이 포함됩니다.
    - id (숫자): 제품 식별자
    - quantity (숫자): 추가할 수량 (최소: 1)
- 반품: 가격 및 할인이 포함된 장바구니 내용이 업데이트되었습니다.
remove_from_cart
- 보관할 항목의 업데이트된 목록을 제공하여 장바구니에서 항목을 제거합니다.
- 입력:
  - store (문자열): 매장 식별자
  - items (배열): 장바구니에 보관할 항목의 업데이트된 목록
- 반품: 장바구니 내용이 업데이트되었습니다.
update_quantity
- 장바구니에 있는 품목의 수량을 업데이트합니다.
- 입력:
  - store (문자열): 매장 식별자
  - id (숫자): 제품 식별자
  - newQuantity (숫자): 제품의 새로운 수량(최소: 1)
- 반품: 장바구니 내용이 업데이트되었습니다.

자원

rami-levy://checkout
- Rami Levy 결제 페이지의 URL을 받으세요
- 반품: 결제 페이지 URL

설정

입증

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

라미 레비 웹사이트 에 로그인하세요
브라우저의 개발자 도구(F12)를 엽니다.
네트워크 탭으로 이동
요청하기(예: 제품 검색)
요청 헤더에서 다음을 추출합니다.
- RAMI_LEVY_API_KEY : Authorization 헤더의 "Bearer" 뒤에 있는 토큰
- ECOM_TOKEN : 전체 ecomtoken 헤더 값
- COOKIE : 전체 쿠키 헤더 값

환경 변수

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

지엑스피1

Claude Desktop과 함께 사용

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

{
  "mcpServers": {
    "rami-levy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-rami-levy"
      ],
      "env": {
        "RAMI_LEVY_API_KEY": "<YOUR_API_KEY>",
        "ECOM_TOKEN": "<YOUR_ECOM_TOKEN>",
        "COOKIE": "<YOUR_COOKIE>"
      }
    }
  }
}

개발

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

서버를 시작합니다:

npm start

보안 고려 사항

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

인증 토큰은 Rami Levy 계정에 대한 전체 액세스를 제공합니다.
토큰은 안전하게 보관되어야 하며 버전 제어에 절대 위탁되어서는 안 됩니다.
토큰은 주기적으로 만료되므로 새로 고쳐야 합니다.
이 구현은 적절한 보안 검토 없이 프로덕션 용도로 의도된 것이 아닙니다.

제한 사항

세션 토큰이 만료되어 수동으로 새로 고쳐야 합니다.
Rami Levy API의 일부 기능은 구현되지 않았습니다(예: 사용자 프로필, 주문 내역)
만료된 세션에 대한 오류 처리가 개선될 수 있습니다.
속도 제한 구현 없음

기여하다

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

특허

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

부인 성명

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

Rami Levy MCP Server