Groceries MCP Server

Groceries MCP サーバー

---

さまざまな食料品ベンダー API に対応した MCP サーバーです。食料品の検索やカートの更新ができます。

機能

• カートの自動作成：指定されたリストに基づいて商品をカートに追加します
• 食料品の検索：ベンダー API を使用して食料品を検索します

ツール

1. add_items_to_cart

• 食料品をカートに追加します。
• 入力：
  • items(list[CartItemScheam])：カートに追加する商品
• 戻り値：更新されたカート

2. search
   • ベンダーの商品を検索します
   • 入力：
     • item (string)：検索する商品
   • 戻り値：検索語句に一致する商品のリスト

セットアップ

環境変数の取得

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 で使用するには、claude_desktop_config.json に次の内容を追加します：

UV

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

ビルド

Docker ビルド：

docker build -t mcp-groceries-server .

ライセンス

この MCP サーバーは MIT ライセンスでライセンスされています。MIT ライセンスの利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。