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 .

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

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

Tools

View all tools

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

Kagi MCP Serverofficial
kagisearch
A
security
A
license
A
quality
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Last updated -
196
MIT License
Agora MCP
Fewsats
A
security
F
license
A
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 -
6
2
Kroger MCP Server
EricLott
-
security
A
license
-
quality
Allows Large Language Models to interact with Kroger's grocery services, enabling product search, store lookup, and cart management through the Model Context Protocol.
Last updated -
1
MIT License
FastFS-MCP
aj-geddes
-
security
F
license
-
quality
A high-speed MCP server that enables AI assistants like Claude to interact with local filesystems, manage Git repositories, and provide interactive experiences through a standardized JSON-based protocol.
Last updated -
5

View all related MCP servers

Kroger MCP Server