Servidor MCP de Kroger

Servidor MCP de Kroger: FastMCP para compras en Kroger

Un servidor FastMCP que proporciona a asistentes de IA como Claude acceso sin problemas a la funcionalidad de compra de Kroger mediante el Protocolo de Contexto de Modelo ( MCP ). Este servidor permite a los asistentes de IA encontrar tiendas, buscar productos, gestionar carritos de compra y acceder a la información completa de Kroger mediante la biblioteca de Python kroger-api .

📺 Demostración

Usando Claude con este servidor MCP para buscar tiendas, encontrar productos y agregar artículos a su carrito:

Demostración de Kroger MCP

🚀 Inicio rápido

Prerrequisitos

Necesitará las credenciales de la API de Kroger (gratuitas en el Portal para desarrolladores de Kroger ). Visite el Portal para desarrolladores de Kroger para:

Crear una cuenta de desarrollador
Registra tu aplicación
Obtenga su CLIENT_ID , CLIENT_SECRET y configure su REDIRECT_URI

La primera vez que ejecute una herramienta que requiera autenticación de usuario, se le solicitará que autorice su aplicación a través de su navegador web. Está otorgando permiso a su propia aplicación registrada , no a terceros.

Instalación

Opción 1: Usar uvx con Claude Desktop (recomendado)

Una vez publicado en PyPI, puede usar uvx para ejecutar el paquete directamente sin clonar el repositorio:

Editar el archivo de configuración de Claude Desktop:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

Linux : ~/.config/Claude/claude_desktop_config.json

Ventanas : %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kroger": {
      "command": "uvx",
      "args": [
        "kroger-mcp"
      ],
      "env": {
        "KROGER_CLIENT_ID": "your_client_id",
        "KROGER_CLIENT_SECRET": "your_client_secret", 
        "KROGER_REDIRECT_URI": "http://localhost:8000/callback",
        "KROGER_USER_ZIP_CODE": "10001"
      }
    }
  }
}

Beneficios de este método:

Instala automáticamente el paquete desde PyPI si es necesario
Crea un entorno aislado para ejecutar el servidor.
Permite mantenerse actualizado con la última versión.
No requiere mantener un clon del repositorio local

Opción 2: Usar uv con un clon local

Primero, clonar localmente:

git clone https://github.com/CupOfOwls/kroger-mcp

Luego, edite el archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "kroger": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/cloned/kroger-mcp",
        "run",
        "kroger-mcp"
      ],
      "env": {
        "KROGER_CLIENT_ID": "your_client_id",
        "KROGER_CLIENT_SECRET": "your_client_secret", 
        "KROGER_REDIRECT_URI": "http://localhost:8000/callback",
        "KROGER_USER_ZIP_CODE": "10001"
      }
    }
  }
}

Opción 3: Instalación desde PyPI

# Install with uv (recommended)
uv pip install kroger-mcp

# Or install with pip
pip install kroger-mcp

Opción 4: Instalación desde la fuente

# Clone the repository
git clone https://github.com/CupOfOwls/kroger-mcp
cd kroger-mcp

# Install with uv (recommended)
uv sync

# Or install with pip
pip install -e .

Configuración

Cree un archivo .env en la raíz de su proyecto o pase valores env a través de la configuración JSON:

# Required: Your Kroger API credentials
KROGER_CLIENT_ID=your_client_id_here
KROGER_CLIENT_SECRET=your_client_secret_here
KROGER_REDIRECT_URI=http://localhost:8000/callback

# Optional: Default zip code for location searches
KROGER_USER_ZIP_CODE=90274

Ejecución del servidor

# With uv (recommended)
uv run kroger-mcp

# With uvx (directly from PyPI without installation)
uvx kroger-mcp

# Or with Python directly
python server.py

# With FastMCP CLI for development
fastmcp dev server.py --with-editable .

🛠️ Características

💬 Avisos MCP integrados

Ruta de compras : encuentre la ruta óptima a través de la tienda para hacer una lista de compras
Comprobación de farmacia : verifique si la farmacia en la ubicación preferida está abierta
Selección de tienda : ayuda al usuario a establecer su tienda Kroger preferida
Compra de recetas : encuentre recetas y agregue ingredientes al carrito

📚 Herramientas disponibles

Herramientas de ubicación

Herramienta	Descripción	Se requiere autorización
`search_locations`	Encuentre tiendas Kroger cerca de un código postal	No
`get_location_details`	Obtenga información detallada sobre una tienda específica	No
`set_preferred_location`	Establecer una tienda preferida para futuras operaciones	No
`get_preferred_location`	Obtenga la tienda preferida configurada actualmente	No
`check_location_exists`	Verificar si un ID de ubicación es válido	No

Herramientas de producto

Herramienta	Descripción	Se requiere autorización
`search_products`	Busque productos por nombre, marca u otros criterios	No
`get_product_details`	Obtenga información detallada del producto, incluidos los precios.	No
`search_products_by_id`	Encuentre productos por su ID de producto específico	No
`get_product_images`	Obtenga imágenes del producto desde una perspectiva específica (frontal, posterior, etc.)	No

Herramientas de carrito

Herramienta	Descripción	Se requiere autorización
`add_items_to_cart`	Añadir un solo artículo al carrito	Sí
`bulk_add_to_cart`	Agregue varios artículos al carrito en una sola operación	Sí
`view_current_cart`	Ver los artículos que se encuentran actualmente en el seguimiento de su carrito local	No
`remove_from_cart`	Eliminar artículos del seguimiento del carrito local	No
`clear_current_cart`	Borrar todos los artículos del seguimiento del carrito local	No
`mark_order_placed`	Mover el carrito actual al historial de pedidos	No
`view_order_history`	Ver el historial de pedidos realizados	No

Herramientas de información

Herramienta	Descripción	Se requiere autorización
`list_chains`	Obtenga todas las cadenas propiedad de Kroger	No
`get_chain_details`	Obtenga detalles sobre una cadena específica	No
`check_chain_exists`	Comprobar si existe una cadena	No
`list_departments`	Obtenga todos los departamentos de la tienda	No
`get_department_details`	Obtenga detalles sobre un departamento específico	No
`check_department_exists`	Comprobar si existe un departamento	No

Herramientas de perfil

Herramienta	Descripción	Se requiere autorización
`get_user_profile`	Obtener información del perfil del usuario autenticado	Sí
`test_authentication`	Probar si el token de autenticación es válido	Sí
`get_authentication_info`	Obtener el estado de autenticación detallado	Sí
`force_reauthenticate`	Borrar tokens y forzar la reautenticación	No

Herramientas de utilidad

Herramienta	Descripción	Se requiere autorización
`get_current_datetime`	Obtener la fecha y hora actual del sistema	No

🧰 Seguimiento de carrito solo local

Dado que la API de Kroger no proporciona la funcionalidad de visualización del carrito, este servidor mantiene el seguimiento local:

Almacenamiento de carritos local

Archivo : kroger_cart.json
Contenido : Artículos del carrito actual con marcas de tiempo
Automático : creado y actualizado automáticamente

Historial de pedidos

Archivo : kroger_order_history.json
Contenido : Órdenes históricas con marcas de tiempo de colocación
Uso : Mueva los carritos completados al historial con mark_order_placed

🚧 Limitaciones de la API pública de Kroger

Solo lectura : Las herramientas remove_from_cart y clear_current_cart SÓLO afectan el seguimiento local, no el carrito real de Kroger
Sincronización local : utilice estas herramientas solo cuando el usuario ya haya eliminado artículos de su carrito en la aplicación o el sitio web de Kroger
Unidireccional : Los artículos se pueden añadir al carrito de Kroger, pero no eliminar, a través de la API pública. La API de socios lo permitiría, pero para ello se requiere un contrato con Kroger.

API	Versión	Límite de velocidad	Notas
Autorización	1.0.13	Sin límite específico	Gestión de tokens
Productos	1.2.4	10.000 llamadas/día	Búsqueda y detalles del producto
Ubicaciones	1.2.2	1.600 llamadas/día por punto final	Ubicaciones y detalles de las tiendas
Carro	1.2.3	5.000 llamadas/día	Agregar/administrar artículos del carrito
Identidad	1.2.3	5.000 llamadas/día	Información del perfil de usuario

Nota: Los límites de velocidad se aplican por punto final, no por operación. Puede distribuir las llamadas entre operaciones utilizando el mismo punto final según sea necesario.

🏫 Flujo de trabajo básico

Establecer una ubicación preferida :
User: "Find Kroger stores near 90274" Assistant: [Uses search_locations tool] User: "Set the first one as my preferred location" Assistant: [Uses set_preferred_location tool]
Buscar y añadir productos :
User: "Add milk to my cart" Assistant: [Uses search_products, then add_items_to_cart] User: "Add bread, eggs, and cheese to my cart" Assistant: [Uses search_products for each, then bulk_add_to_cart]
Gestionar carrito y pedidos :
User: "What's in my cart?" Assistant: [Uses view_current_cart tool to see local memory] User: "I placed the order on the Kroger website" Assistant: [Uses mark_order_placed tool, moving current cart to the order history]

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abra una incidencia para comentar qué desea cambiar.

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

⚠️ Descargo de responsabilidad

Este es un servidor MCP no oficial para la API pública de Kroger. No está afiliado, respaldado ni patrocinado por Kroger.

Si tiene preguntas sobre la API de Kroger, visite el Portal para desarrolladores de Kroger o lea la documentación del paquete kroger-api .

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Un servidor FastMCP que brinda a los asistentes de IA como Claude acceso sin inconvenientes a la funcionalidad de compra de comestibles de Kroger a través del Protocolo de contexto de modelo, lo que permite encontrar tiendas, buscar productos y administrar carritos.

Related MCP Servers

Exa MCP Server
exa-labs
A
security
A
license
A
quality
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Last updated -
1
2,167
1,631
TypeScript
MIT License
lunchmoney-mcp
leafeye
A
security
A
license
A
quality
An MCP server that lets AI assistants interact with your Lunchmoney data, enabling natural language queries about transactions, budgets, and spending patterns.
Last updated -
4
3
8
TypeScript
MIT License
Trading Simulator MCP Server
recallnet
-
security
F
license
-
quality
An MCP server that enables AI models like Claude to interact with the Trading Simulator API for checking balances, viewing prices, and executing trades with automatic chain detection.
Last updated -
TypeScript
Agora MCP
Fewsats
-
security
F
license
-
quality
An MCP server that connects AI assistants to SearchAgora, enabling users to search for, discover, and purchase products across the web through natural language conversations.
Last updated -
1
Python

View all related MCP servers

Kroger MCP Server