mcpField
G
Groceries MCP Server

Groceries MCP Server

Local
github.com/o-b-oneBusiness & Marketing3Updated 39w ago
Repository

About Groceries MCP Server

Groceries MCP Server provides product search and cart updates through grocery vendor APIs. It is for workflows that look up products and add a supplied list to a cart; the README shows credential setup for Rami Levy.

Key features

  1. 01Search products through vendor APIs
  2. 02Add listed items to a cart
  3. 03Return the updated cart

Use cases

  1. 01Look up products in a vendor catalog
  2. 02Create or update a cart from a grocery list

MCP support

The MCP server exposes product search and cart operations to clients, using vendor APIs to find products and add them to a cart.

#groceries

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Groceries MCP Server

MCP Server for different Groceries vendor API, enabling searching groceries and cart update.

Features
  • Automatic cart creation: add items to the cart based on a provided list
  • Groceries lookup: lookup for groceries using vendor API

Tools

  1. add_items_to_cart
  • Add groceries to the basket.
  • Inputs:
    • items(list[CartItemScheam]): items to add to the cart
  • Returns: Updated cart
  1. search
    • Lookup for item in the vendor
    • Inputs:
      • item (string): Items to
    • Returns: list of items corresponding to search term

Setup

Extract Environment Variables

Rami Levy
  1. log in to the Rami Levy site
  2. In developer tools (click on F12) and execute:
const state = JSON.parse(localStorage.ramilevy);
console.log({
    "VENDOR_ACCOUNT_ID": state.authuser.user.id,
    "VENDOR_API_KEY": state.authuser.user.token,
});
  1. Replace environment variables with the printed values
Local usage
  1. Update the .env file using env.template (requires Gemini)
  2. Update the grocery.txt
  3. Run make compile start_agent
Usage with Claude Desktop

To use this with Claude Desktop, add the following to your 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>"
      }
    }
  }
}

Build

Docker build:

docker build -t mcp-groceries-server .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.