ラミ・レヴィ 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 と提携しておらず、同社から承認も受けていません。すべての製品名、ロゴ、ブランドはそれぞれの所有者の財産です。