Rami Levy

🚀 Rami Levy MCP Server

The MCP server for the Rami Levy online grocery store API. This implementation demonstrates how to integrate Rami Levy's e-commerce platform with an MCP-enabled LLM.

🚀 Quick Start

The Rami Levy MCP Server offers a seamless way to interact with the Rami Levy online grocery store API. It enables integration with MCP-enabled LLMs, providing a range of useful tools for product search, cart management, and more.

✨ Features

Tools

1. search_items

   • Search for products in the catalog.
   • Input:
     • q (string): Search query.
     • store (string, optional): Store identifier (default: "331").
     • aggs (number, optional): Aggregation flag (default: 1).
   • Return: An array of products containing name, price, image URL, and ID.

2. add_to_cart

   • Add one or more items to the cart.
   • Input:
     • store (string): Store identifier (e.g., "331").
     • items (array): List of items to add, each containing:
       • id (number): Product identifier.
       • quantity (number): Quantity to add (minimum: 1).
   • Return: Updated cart contents, including price and discount.

3. remove_from_cart

   • Remove items from the cart by providing a list of items to keep.
   • Input:
     • store (string): Store identifier.
     • items (array): Updated list of items to keep in the cart.
   • Return: Updated cart contents.

4. update_quantity

   • Update the quantity of an item in the cart.
   • Input:
     • store (string): Store identifier.
     • id (number): Product identifier.
     • newQuantity (number): New quantity of the product (minimum: 1).
   • Return: Updated cart contents.

Resources

1. rami-levy://checkout
   • Get the URL of the Rami Levy checkout page.
   • Return: Checkout page URL.

📦 Installation

Authentication

This MCP server requires authentication tokens from an active Rami Levy session. To obtain these:

1. Log in to the Rami Levy website.
2. Open your browser's developer tools (F12).
3. Go to the Network tab.
4. Make any request (e.g., search for a product).
5. Extract from the request headers:
   • RAMI_LEVY_API_KEY: The token after "Bearer" in the Authorization header.
   • ECOM_TOKEN: The full value of the ecomtoken header.
   • COOKIE: The full value of the cookie header.

Environment Variables

Create a .env file with the following variables:

RAMI_LEVY_API_KEY=your_api_key_here
ECOM_TOKEN=your_ecom_token_here
COOKIE=your_cookie_string_here

Usage with Claude Desktop

Add the following to claude_desktop_config.json:

{
    "mcpServers": {
        "rami-levy": {
            "command": "npx",
            "args": [
                "rami-levy"
            ]
        }
    }
}

💻 Usage Examples

Development

Install Dependencies

Install the required packages using the following command:

npm install express cors

Run the Server

Run the index.js script to start the MCP server.

🔧 Technical Details

Security Considerations

• Ensure that sensitive information (such as API keys and tokens) is not exposed to the client.
• Regularly update dependencies to prevent known security vulnerabilities.

Limitations

• The current version only supports a limited set of API functions.
• There may be performance bottlenecks, especially under high traffic.

🤝 Contribution

To contribute to the project, please follow these steps:

1. Create a feature branch.
2. Commit your changes.
3. Open a pull request for review.

📄 License

[Add license information here]

This document provides a comprehensive overview of the Rami Levy MCP Server, including tools, setup, and development guidelines. For further assistance, please refer to the relevant resources or contact the support team.