Mon Marché MCP Server

A Model Context Protocol (MCP) server that connects LLMs to the Mon Marché French grocery store. This server enables AI assistants to search for products, manage a shopping cart, and interact with the Mon Marché platform.

Features

• Product Search: Find products by name.
• Cart Management:
  • Add items to cart.
  • View current cart contents.
  • Clear the entire cart.
• Session Handling: Automated login and session persistence via cookies.

Prerequisites

• Node.js (v16 or higher)
• npm or yarn
• A valid Mon Marché account

Installation

1. Clone the repository:

   git clone https://github.com/Chopin85/mcp-server-monmarche
   cd mcp-server-monmarche

2. Install dependencies:

   npm install

3. Configure Environment: Copy the example environment file and add your credentials:

   cp .env.example .env

   Edit .env and fill in your details:

   [email protected]
   MON_MARCHE_PASSWORD=your-password

4. Build the project:

   npm run build

Configuration & Authentication

Before using the MCP server or tools, you must authenticate to generate a session.

Run the login script:

npm run login

This command logs in using credentials from .env and saves the session cookies to session-cookie.json.

[!IMPORTANT] You must re-run npm run login if your session expires or if you delete session-cookie.json.

Usage

Running the MCP Server

To start the server for use with an MCP client (like Claude Desktop or an IDE extension):

node dist/index.js

Testing with MCP Inspector

You can test the tools interactively using the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

CLI Tools

The project includes helper scripts to run tools directly from the command line for testing or automation:

• Search: npm run searchProducts "pomme"
• Add to Cart: npm run addProduct -- --id <PRODUCT_ID> --quantity <QTY>
• View Cart: npm run getCartList
• Clear Cart: npm run clearCart

Available Tools

The server exposes the following tools to MCP clients:

searchProduct

Searches for products on Mon Marché.

• Input: { "query": { "name": "string" } }
• Returns: List of matching products with IDs and details.

addProduct

Adds a specific product to the cart.

• Input: { "product": { "id": "string", "quantity": number } }
• Returns: Confirmation of addition.

getCartList

Retrieves the current contents of the shopping cart.

• Input: {} (No input required)
• Returns: List of items in the cart.

clearCart

Removes all items from the shopping cart.

• Input: {} (No input required)
• Returns: Confirmation message.

Troubleshooting

• Login Failed: Ensure your email and password in .env are correct.
• Session Errors: If tools return authentication errors, run npm run login to refresh your session cookies.
• Build Errors: Make sure all dependencies are installed with npm install.

License

This project is licensed under the ISC License.