what is Groceries MCP Server?
Groceries MCP Server is a server designed for groceries vendors that enables searching for groceries and updating shopping carts through various vendor APIs.
how to use Groceries MCP Server?
To use the Groceries MCP Server, set up the environment variables, update the necessary configuration files, and run the server using Docker or with Claude Desktop integration.
key features of Groceries MCP Server?
- Automatic cart creation based on a provided list of items.
- Groceries lookup functionality using vendor APIs.
use cases of Groceries MCP Server?
- Vendors can automate the process of adding items to customer carts.
- Users can search for groceries across different vendor APIs seamlessly.
FAQ from Groceries MCP Server?
- How do I set up the environment variables?
You can extract the necessary environment variables by logging into the vendor site and using developer tools to access local storage.
- Is there a Docker setup available?
Yes! You can build the server using Docker with the provided commands in the documentation.
- What license is the Groceries MCP Server under?
The server is licensed under the MIT License, allowing free use, modification, and distribution.
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
add_items_to_cart
- Add groceries to the basket.
- Inputs:
items(list[CartItemScheam]): items to add to the cart
- Returns: Updated cart
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
- log in to the Rami Levy site
- 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,
});
- Replace environment variables with the printed values
Local usage
- Update the
.envfile usingenv.template(requires Gemini) - Update the
grocery.txt - 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 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.
