Servidor MCP de Rami Levy

Servidor MCP para la API de la tienda de comestibles en línea Rami Levy. Esta es una implementación de prueba de concepto que demuestra cómo integrar la plataforma de comercio electrónico de Rami Levy con LLM compatibles con MCP.

Herramientas

1. search_items

   • Buscar productos en el catálogo de Rami Levy

   • Entradas:

     • q (cadena): consulta de búsqueda

     • store (cadena, opcional): identificador de la tienda (predeterminado: "331")

     • aggs (número, opcional): Indicador de agregación (predeterminado: 1)

   • Devoluciones: Matriz de productos con nombre, precio, URL de imagen e ID

2. add_to_cart

   • Añade uno o más artículos al carrito de compras

   • Entradas:

     • store (cadena): identificador de la tienda (p. ej., "331")

     • items (matriz): lista de elementos para agregar, cada uno contiene:

       • id (número): identificador del producto

       • quantity (número): Cantidad a añadir (mínimo: 1)

   • Devoluciones: Contenido del carrito actualizado con precios y descuentos.

3. remove_from_cart

   • Eliminar artículos del carrito proporcionando una lista actualizada de artículos para conservar

   • Entradas:

     • store (cadena): identificador de la tienda

     • items (matriz): lista actualizada de artículos para mantener en el carrito

   • Devoluciones: Contenido del carrito actualizado

4. update_quantity

   • Actualizar la cantidad de un artículo en el carrito

   • Entradas:

     • store (cadena): identificador de la tienda

     • id (número): identificador del producto

     • newQuantity (número): Nueva cantidad del producto (mínimo: 1)

   • Devoluciones: Contenido del carrito actualizado

Related MCP server: Merge MCP Server

Recursos

1. rami-levy://checkout

   • Obtenga la URL de la página de pago de Rami Levy

   • Devoluciones: URL de la página de pago

Configuración

Autenticación

Este servidor MCP requiere tokens de autenticación de una sesión activa de Rami Levy. Para obtenerlos:

1. Inicie sesión en el sitio web de Rami Levy

2. Abra las herramientas para desarrolladores de su navegador (F12)

3. Vaya a la pestaña Red

4. Realizar cualquier solicitud (por ejemplo, buscar un producto)

5. De los encabezados de solicitud, extraiga:

   • RAMI_LEVY_API_KEY : El token después de "Bearer" en el encabezado de autorización

   • ECOM_TOKEN : El valor completo del encabezado ecomtoken

   • COOKIE : El valor completo del encabezado de la cookie

Variables de entorno

Crea un archivo .env con las siguientes variables:

RAMI_LEVY_API_KEY=your_api_key_here
ECOM_TOKEN=your_ecom_token_here
COOKIE=your_cookie_string_here

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

{
  "mcpServers": {
    "rami-levy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-rami-levy"
      ],
      "env": {
        "RAMI_LEVY_API_KEY": "<YOUR_API_KEY>",
        "ECOM_TOKEN": "<YOUR_ECOM_TOKEN>",
        "COOKIE": "<YOUR_COOKIE>"
      }
    }
  }
}

Desarrollo

1. Instalar dependencias:

npm install

2. Construir el proyecto:

npm run build

3. Iniciar el servidor:

npm start

Consideraciones de seguridad

⚠️ Importante : Esta es una prueba de concepto. Nota:

1. Los tokens de autenticación proporcionan acceso completo a su cuenta de Rami Levy

2. Los tokens deben mantenerse seguros y nunca comprometerse con el control de versiones.

3. Los tokens caducan periódicamente y deberán actualizarse.

4. Esta implementación no está destinada para uso en producción sin una revisión de seguridad adecuada.

Limitaciones

1. Los tokens de sesión expiran y deben actualizarse manualmente

2. Algunas funciones de la API de Rami Levy no están implementadas (por ejemplo, perfil de usuario, historial de pedidos)

3. Se podría mejorar el manejo de errores de sesiones caducadas

4. No hay implementación de limitación de velocidad

Contribuyendo

¡Se aceptan problemas y solicitudes de extracción! Asegúrate de no enviar información confidencial, como tokens de autenticación.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Descargo de responsabilidad

Este es un proyecto no oficial y no está afiliado ni respaldado por Rami Levy Chain Stores Ltd. Todos los nombres de productos, logotipos y marcas son propiedad de sus respectivos dueños.