Rami Levy

🚀 Rami Levy MCP サーバー

Rami Levyのオンライン食料品店APIのMCPサーバーです。この実装は、Rami Levyの電子商取引プラットフォームをMCP対応のLLMと統合する方法をデモンストレーションするためのものです。

✨ 主な機能

ツール

1. search_items

   • カタログ内の商品を検索します。
   • 入力:
     • 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. Rami Levyウェブサイトにログインします。
2. ブラウザの開発者ツール（F12）を開きます。
3. ネットワークタブに移動します。
4. 任意のリクエストを送信します（例：商品検索）。
5. リクエストヘッダーから以下を抽出します。
   • RAMI_LEVY_API_KEY：認証ヘッダーの "Bearer" の後のトークン
   • ECOM_TOKEN：完全なecomtokenヘッダー値
   • 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": [
        "rami-levy"
      ]
    }
  }
}

開発

依存関係のインストール

必要なパッケージを以下のコマンドでインストールします。

npm install express cors

サーバーの起動

index.js スクリプトを実行してMCPサーバーを起動します。

🔧 技術詳細

セキュリティ上の考慮事項

• クライアントにAPIキーやトークンなどの機密情報が公開されないようにしてください。
• 既知のセキュリティホールを防止するために、定期的に依存関係を更新してください。

制限事項

• 現在のバージョンは限られたAPI機能のみをサポートしています。
• 特に高トラフィック時には、パフォーマンスのボトルネックが発生する可能性があります。

貢献方法

プロジェクトに貢献するには、以下の手順に従ってください。

1. 機能ブランチを作成します。
2. 変更をコミットします。
3. レビューのためのプルリクエストを作成します。

📄 ライセンス

[ここにライセンス情報を追加]

このドキュメントは、Rami Levy MCPサーバーの包括的な概要を提供しており、ツール、設定、および開発ガイドが含まれています。さらなる支援が必要な場合は、関連するリソースを参照するか、サポートチームに連絡してください。