ラミ・レヴィ MCP サーバー

Rami Levyオンライン食料品店API用のMCPサーバー。これは、Rami LevyのeコマースプラットフォームをMCP対応LLMと統合する方法を示す概念実証実装です。

ツール

1. search_items
   • Rami Levyのカタログで製品を検索
   • 入力:
     • q (文字列): 検索クエリ
     • store (文字列、オプション): ストア識別子 (デフォルト: "331")
     • aggs （数値、オプション）：集約フラグ（デフォルト：1）
   • 戻り値: 名前、価格、画像 URL、ID を含む製品の配列
2. add_to_cart
   • ショッピングカートに1つ以上の商品を追加する
   • 入力:
     • store (文字列): 店舗識別子 (例: "331")
     • items (配列): 追加するアイテムのリスト。各アイテムには次の内容が含まれます。
       • id (番号): 製品識別子
       • quantity （数値）：追加する数量（最小：1）
   • 返品: 価格と割引を反映したカートの内容を更新しました
3. remove_from_cart
   • 保管するアイテムの更新されたリストを提供して、カートからアイテムを削除します
   • 入力:
     • store (文字列): 店舗識別子
     • items (配列): カートに保持するアイテムの更新されたリスト
   • 返品: カートの内容を更新しました
4. update_quantity
   • カート内の商品の数量を更新する
   • 入力:
     • store (文字列): 店舗識別子
     • id (番号): 製品識別子
     • newQuantity (数値): 商品の新しい数量（最小: 1）
   • 返品: カートの内容を更新しました

リソース

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 : 完全なCookieヘッダー値

環境変数

次の変数を含む.envファイルを作成します。

Claude Desktopでの使用

claude_desktop_config.jsonに以下を追加します。

発達

1. 依存関係をインストールします:

2. プロジェクトをビルドします。

3. サーバーを起動します。

セキュリティに関する考慮事項

⚠️重要：これは概念実証の実装です。ご注意ください：

1. 認証トークンはRami Levyアカウントへのフルアクセスを提供します
2. トークンは安全に保管し、バージョン管理にコミットしないでください。
3. トークンは定期的に期限切れとなり、更新が必要になります
4. この実装は、適切なセキュリティレビューなしでの本番環境での使用を意図したものではありません。

制限事項

1. セッショントークンは期限切れとなり、手動で更新する必要がある
2. Rami Levy API の一部の機能は実装されていません (例: ユーザー プロファイル、注文履歴)
3. 期限切れのセッションのエラー処理を改善できる可能性がある
4. レート制限の実装なし

貢献

問題やプルリクエストは大歓迎です。認証トークンなどの機密情報はコミットしないようにご注意ください。

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

免責事項

これは非公式のプロジェクトであり、Rami Levy Chain Stores Ltd と提携しておらず、同社から承認も受けていません。すべての製品名、ロゴ、ブランドはそれぞれの所有者の財産です。