Groceries MCP Server

Name: Groceries MCP Server
Author: o-b-one

@o-b-one

リポジトリ

Groceries MCP Server について

An mcp server for groceries vendors

#groceries

基本情報

カテゴリ

その他

ランタイム

python

トランスポート

stdio

公開者

o-b-one

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

`items`(list[CartItemScheam]): items to add to the cart

Updated cart

概要

What is Groceries MCP Server?

It is an MCP server that interfaces with grocery vendor APIs (such as Rami Levy and Keshet), enabling users to search for groceries and manage cart updates automatically. It is intended for developers building AI‑powered grocery assistants.

How to use Groceries MCP Server?

Obtain a vendor API key and account ID from the vendor’s website (e.g., from localStorage on the Rami Levy site). Set environment variables (VENDOR_API_KEY, VENDOR_ACCOUNT_ID) in a .env file or in the Claude Desktop configuration. Then run the server via uv run mcp-groceries-server --vendor <vendorName> or use the provided Docker image.

Key features of Groceries MCP Server

Automatic cart creation: adds items to the cart from a provided list.
Grocery lookup: searches for groceries via vendor APIs.
Two MCP tools: add_items_to_cart and search.
Supports multiple grocery vendors (e.g., Rami Levy, Keshet).

Use cases of Groceries MCP Server

Creating a grocery order by sending a list of items to an AI assistant.
Searching for a specific product in a vendor’s catalog before adding it.
Automating recurrent grocery purchases through an MCP‑enabled client (like Claude Desktop).

FAQ from Groceries MCP Server

Which vendors are supported?

The README mentions Rami Levy and Keshet as available vendor names when starting the server.

How do I obtain the required credentials?

For Rami Levy, log in to the site, open developer tools (F12), and run the provided JavaScript snippet to extract VENDOR_ACCOUNT_ID and VENDOR_API_KEY from localStorage.

What MCP tools does this server provide?

Two tools: add_items_to_cart (accepts a list of items and returns the updated cart) and search (accepts a search string and returns matching items).