Groceries MCP

🚀 食品雑貨 MCP サーバー

この食品雑貨 MCP サーバーは、自動ショッピングカートの作成や食品雑貨の検索などの機能を提供し、食品雑貨の購入を効率化します。

🚀 クイックスタート

このサーバーを使用するには、まず環境変数の設定や必要なファイルの更新が必要です。詳細な手順は「🔧 セットアップ」を参照してください。

✨ 主な機能

• 自動ショッピングカート作成：提供された商品リストに基づき、商品をショッピングカートに自動的に追加します。
• 食品雑貨検索：vendors API を通じて食品雑貨を検索することができます。

📦 インストール

環境変数の設定

Rami Levy

1. Rami Levy のウェブサイトにログインします。
2. 開発者ツール（F12 キーを押す）を開き、以下のコードを実行します。

   const state = JSON.parse(localStorage.ramilevy);
   console.log({
       "VENDOR_ACCOUNT_ID": state.authuser.user.id,
       "VENDOR_API_KEY": state.authuser.user.token,
   });
   

3. コンソールに表示された値を環境変数に設定します。

ローカルでの使用

1. env.template を使用して .env ファイルを更新します（Gemini が必要です）。
2. grocery.txt を更新します。
3. make compile start_agent を実行します。

Claude Desktop での使用

Claude Desktop でこの MCP サーバーを使用するには、claude_desktop_config.json に以下の内容を追加します。

UV

{
  "mcpServers": {
    "groceries": {
      "command": "uv",
      "args": [
        "run",
        "mcp-groceries-server",
        "--vendor",
        vendorName # 例：rami-levy, keshet など
      ],
      "env":{
        "VENDOR_API_KEY": "<YOUR_API_TOKEN>",
        "VENDOR_ACCOUNT_ID": "<VENDOR_ACCOUNT_ID>"
      }
    }
  }
}

Docker ビルド

Docker を使用してサーバーをビルドするには、以下のコマンドを実行します。

docker build -t mcp-groceries-server .

💻 使用例

基本的な使用法

以下のツールを使用して、商品の追加や検索を行うことができます。

add_items_to_cart

このツールは、商品をショッピングカートに追加します。

• 入力:
  • items(list[CartItemScheam]): カートに追加する商品のリスト
• 出力: 更新されたカート

search

このツールは、vendor 内で商品を検索します。

• 入力:
  • item (string): 検索する商品の名前
• 出力: 検索キーワードに一致する商品のリスト

📚 ドキュメント

ツールの詳細

• add_items_to_cart: 商品をショッピングカートに追加します。
• search: vendor 内で商品を検索します。

環境変数の設定

• Rami Levy の環境変数を設定するには、上記の手順に従ってください。
• ローカルで使用する場合は、.env ファイルを更新し、必要なコマンドを実行します。
• Claude Desktop で使用する場合は、claude_desktop_config.json に必要な設定を追加します。

Docker ビルド

Docker を使用してサーバーをビルドするには、docker build -t mcp-groceries-server . を実行します。

📄 ライセンス

この MCP サーバーは MIT License に基づいて配布されています。これにより、ソフトウェアを自由に使用、変更、配布することができますが、MIT License の条項に従う必要があります。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。