ラミ・レヴィ 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）

   • 返品: カートの内容を更新しました

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

環境変数

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

RAMI_LEVY_API_KEY=your_api_key_here
ECOM_TOKEN=your_ecom_token_here
COOKIE=your_cookie_string_here

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>"
      }
    }
  }
}

発達

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

npm install

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

npm run build

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

npm start

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

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

1. 認証トークンはRami Levyアカウントへのフルアクセスを提供します

2. トークンは安全に保管し、バージョン管理にコミットしないでください。

3. トークンは定期的に期限切れとなり、更新が必要になります

4. この実装は、適切なセキュリティレビューなしでの本番環境での使用を意図したものではありません。

制限事項

1. セッショントークンは期限切れとなり、手動で更新する必要がある

2. Rami Levy API の一部の機能は実装されていません (例: ユーザー プロファイル、注文履歴)

3. 期限切れのセッションのエラー処理を改善できる可能性がある

4. レート制限の実装なし

貢献

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

ライセンス

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

免責事項

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