Rami Levy

Servidor MCP de Rami Levy

Servidor MCP para la API de la tienda de comestibles en línea de 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 LLMs habilitados para 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 tienda (por defecto: "331")
     • aggs (número, opcional): Indicador de agregación (por defecto: 1)
   • Devuelve: Arreglo de productos con nombre, precio, URL de imagen e ID

2. add_to_cart

   • Agregar uno o más artículos al carrito de compras
   • Entradas:
     • store (cadena): Identificador de tienda (p. ej., "331")
     • items (arreglo): Lista de artículos a agregar, cada uno contiene:
       • id (número): Identificador de producto
       • quantity (número): Cantidad a agregar (mínimo: 1)
   • Devuelve: Contenido actualizado del carrito con precios y descuentos

3. remove_from_cart

   • Eliminar artículos del carrito proporcionando una lista actualizada de artículos a conservar
   • Entradas:
     • store (cadena): Identificador de tienda
     • items (arreglo): Lista actualizada de artículos a conservar en el carrito
   • Devuelve: Contenido actualizado del carrito

4. update_quantity

   • Actualizar la cantidad de un artículo en el carrito
   • Entradas:
     • store (cadena): Identificador de tienda
     • id (número): Identificador de producto
     • newQuantity (número): Nueva cantidad para el producto (mínimo: 1)
   • Devuelve: Contenido actualizado del carrito

Recursos

1. rami-levy://checkout
   • Obtener la URL de la página de pago de Rami Levy
   • Devuelve: 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. Inicia sesión en el sitio web de Rami Levy
2. Abre las herramientas de desarrollador de tu navegador (F12)
3. Ve a la pestaña Red
4. Realiza cualquier solicitud (p. ej., busca un producto)
5. De los encabezados de la solicitud, extrae:
   • RAMI_LEVY_API_KEY: El token después de "Bearer" en el encabezado Authorization
   • ECOM_TOKEN: El valor completo del encabezado ecomtoken
   • COOKIE: El valor completo del encabezado 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

Agrega lo siguiente a tu 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. Instala las dependencias:

npm install

2. Compila el proyecto:

npm run build

3. Inicia el servidor:

npm start

Consideraciones de seguridad

⚠️ Importante: Esta es una implementación de prueba de concepto. Ten en cuenta:

1. Los tokens de autenticación proporcionan acceso completo a tu cuenta de Rami Levy
2. Los tokens deben mantenerse seguros y nunca deben enviarse al control de versiones
3. Los tokens expiran 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 características de la API de Rami Levy no están implementadas (p. ej., perfil de usuario, historial de pedidos)
3. El manejo de errores para sesiones expiradas podría mejorarse
4. No hay implementación de limitación de velocidad

Contribuciones

¡Los problemas y las solicitudes de extracción son bienvenidos! Asegúrate de no enviar información sensible como tokens de autenticación.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

Aviso legal

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.