Groceries MCP

🚀 Groceries MCP Server

This server provides automatic shopping cart creation and grocery search functions, facilitating users to manage grocery shopping.

🚀 Quick Start

The Groceries MCP Server offers two main features: automatic shopping cart creation and grocery search. You can use the provided tools to add items to the cart and search for groceries.

✨ Features

• Automatic Shopping Cart Creation: Add items to the shopping cart based on the provided item list.
• Grocery Search: Find groceries through the vendors API.

📚 Documentation

🛠️ Tools

1. add_items_to_cart
   • Adds items to the shopping cart.
   • Input:
     • items (list[CartItemScheam]): Items to be added to the cart.
   • Output: The updated shopping cart.
2. search
   • Searches for items among vendors.
   • Input:
     • item (string): The item to search for.
   • Output: A list of items corresponding to the search term.

⚙️ Setup

Environment Variable Configuration

Rami Levy

1. Log in to the Rami Levy website.
2. Execute the following code in the developer tools (press F12):

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

3. Replace the environment variables with the printed values.

Local Usage

1. Update the .env file using env.template (requires Gemini).
2. Update grocery.txt.
3. Run make compile start_agent.

Using Claude Desktop

To use this MCP server in Claude Desktop, add the following content to your claude_desktop_config.json:

UV

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

🏗️ Build

Docker build command:

docker build -t mcp-groceries-server .

📄 License

This MCP server is distributed 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 refer to the LICENSE file in the project repository.