🛒 Kroger MCP-Server 🛍️ – FastMCP für Kroger-Einkäufe

Ein FastMCP -Server, der KI-Assistenten wie Claude über das Model Context Protocol ( MCP ) nahtlosen Zugriff auf die Lebensmitteleinkaufsfunktionen von Kroger bietet. Dieser Server ermöglicht es KI-Assistenten, Geschäfte zu finden, Produkte zu suchen, Einkaufswagen zu verwalten und über die Python-Bibliothek „ kroger-api“ auf die umfassenden Lebensmitteldaten von Kroger zuzugreifen.

📺 Demo

Verwenden Sie Claude mit diesem MCP-Server, um nach Geschäften zu suchen, Produkte zu finden und Artikel zu Ihrem Einkaufswagen hinzuzufügen:

Kroger MCP-Demo

🚀 Schnellstart

Voraussetzungen

Sie benötigen Kroger-API-Anmeldeinformationen (kostenlos im Kroger Developer Portal ). Besuchen Sie das Kroger Developer Portal für:

Erstellen Sie ein Entwicklerkonto
Registrieren Sie Ihre Anwendung
Holen Sie sich Ihre CLIENT_ID , CLIENT_SECRET und legen Sie Ihre REDIRECT_URI fest

Wenn Sie zum ersten Mal ein Tool ausführen, das eine Benutzerauthentifizierung erfordert, werden Sie aufgefordert, Ihre App über Ihren Webbrowser zu autorisieren. Sie erteilen die Berechtigung Ihrer eigenen registrierten App , nicht einer Drittanbieter-App.

Installation

Option 1: Verwenden von uvx mit Claude Desktop (empfohlen)

Nach der Veröffentlichung in PyPI können Sie uvx verwenden, um das Paket direkt auszuführen, ohne das Repository zu klonen:

Bearbeiten Sie die Konfigurationsdatei von Claude Desktop:

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

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

Windows : %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" } } } }

Vorteile dieser Methode:

Installiert das Paket bei Bedarf automatisch von PyPI
Erstellt eine isolierte Umgebung zum Ausführen des Servers
Macht es einfach, mit der neuesten Version auf dem Laufenden zu bleiben
Erfordert keine Pflege eines lokalen Repository-Klons

Option 2: Verwenden von UV mit einem lokalen Klon

Klonen Sie zunächst lokal:

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

Bearbeiten Sie dann die Konfigurationsdatei von 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" } } } }

Option 3: Installation von PyPI

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

Option 4: Installation von der Quelle

# 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 .

Konfiguration

Erstellen Sie eine .env Datei im Stammverzeichnis Ihres Projekts oder übergeben Sie Umgebungswerte über die JSON-Konfiguration:

# 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

Ausführen des Servers

# 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 .

🛠️ Funktionen

💬 Integrierte MCP-Eingabeaufforderungen

Einkaufspfad : Finden Sie den optimalen Pfad durch das Geschäft für eine Einkaufsliste
Apotheken-Check : Prüfen Sie, ob die Apotheke am gewünschten Standort geöffnet ist
Filialauswahl : Helfen Sie dem Benutzer, seine bevorzugte Kroger-Filiale auszuwählen
Rezepte einkaufen : Rezepte finden und Zutaten in den Einkaufswagen legen

📚 Verfügbare Tools

Standorttools

Werkzeug	Beschreibung	Authentifizierung erforderlich
`search_locations`	Finden Sie Kroger-Filialen in der Nähe einer Postleitzahl	NEIN
`get_location_details`	Erhalten Sie detaillierte Informationen zu einem bestimmten Geschäft	NEIN
`set_preferred_location`	Legen Sie einen bevorzugten Store für zukünftige Vorgänge fest	NEIN
`get_preferred_location`	Den aktuell eingestellten bevorzugten Store abrufen	NEIN
`check_location_exists`	Überprüfen, ob eine Standort-ID gültig ist	NEIN

Produkttools

Werkzeug	Beschreibung	Authentifizierung erforderlich
`search_products`	Suchen Sie nach Produkten nach Namen, Marke oder anderen Kriterien	NEIN
`get_product_details`	Erhalten Sie detaillierte Produktinformationen einschließlich Preisen	NEIN
`search_products_by_id`	Suchen Sie nach Produkten anhand ihrer spezifischen Produkt-ID	NEIN
`get_product_images`	Erhalten Sie Produktbilder aus einer bestimmten Perspektive (Vorderseite, Rückseite usw.)	NEIN

Warenkorb-Tools

Werkzeug	Beschreibung	Authentifizierung erforderlich
`add_items_to_cart`	Einen einzelnen Artikel in den Warenkorb legen	Ja
`bulk_add_to_cart`	Mehrere Artikel in einem Vorgang in den Warenkorb legen	Ja
`view_current_cart`	Zeigen Sie Artikel an, die sich derzeit in Ihrer lokalen Warenkorbverfolgung befinden	NEIN
`remove_from_cart`	Artikel aus der lokalen Warenkorbverfolgung entfernen	NEIN
`clear_current_cart`	Alle Artikel aus der lokalen Warenkorbverfolgung löschen	NEIN
`mark_order_placed`	Aktuellen Warenkorb in den Bestellverlauf verschieben	NEIN
`view_order_history`	Verlauf der aufgegebenen Bestellungen anzeigen	NEIN

Informationstools

Werkzeug	Beschreibung	Authentifizierung erforderlich
`list_chains`	Holen Sie sich alle Kroger-eigenen Ketten	NEIN
`get_chain_details`	Erhalten Sie Details zu einer bestimmten Kette	NEIN
`check_chain_exists`	Prüfen, ob eine Kette vorhanden ist	NEIN
`list_departments`	Alle Abteilungen des Geschäfts abrufen	NEIN
`get_department_details`	Erhalten Sie Details zu einer bestimmten Abteilung	NEIN
`check_department_exists`	Prüfen, ob eine Abteilung vorhanden ist	NEIN

Profilwerkzeuge

Werkzeug	Beschreibung	Authentifizierung erforderlich
`get_user_profile`	Profilinformationen des authentifizierten Benutzers abrufen	Ja
`test_authentication`	Testen, ob das Authentifizierungstoken gültig ist	Ja
`get_authentication_info`	Detaillierten Authentifizierungsstatus abrufen	Ja
`force_reauthenticate`	Token löschen und erneute Authentifizierung erzwingen	NEIN

Hilfsprogramme

Werkzeug	Beschreibung	Authentifizierung erforderlich
`get_current_datetime`	Aktuelles Systemdatum und Uhrzeit abrufen	NEIN

🧰 Nur lokales Warenkorb-Tracking

Da die Kroger-API keine Funktion zur Anzeige von Einkaufswagen bietet, verwaltet dieser Server die lokale Verfolgung:

Lokale Warenkorbspeicherung

Datei : kroger_cart.json
Inhalt : Aktuelle Warenkorbartikel mit Zeitstempel
Automatisch : Automatisch erstellt und aktualisiert

Bestellverlauf

Datei : kroger_order_history.json
Inhalt : Historische Bestellungen mit Platzierungszeitstempeln
Verwendung : Verschieben Sie abgeschlossene Einkaufswagen mit mark_order_placed in den Verlauf

🚧 Einschränkungen der öffentlichen API von Kroger

Nur anzeigen : Die Tools remove_from_cart und clear_current_cart wirken sich NUR auf die lokale Sendungsverfolgung aus, nicht auf den eigentlichen Kroger-Warenkorb.
Lokale Synchronisierung : Verwenden Sie diese Tools nur, wenn der Benutzer bereits Artikel aus seinem Warenkorb in der Kroger-App/Website entfernt hat
Einweg : Artikel können über die öffentliche API in den Warenkorb von Kroger gelegt, aber nicht daraus entfernt werden. Die Partner-API würde dies ermöglichen, erfordert aber einen Vertrag mit Kroger.

API	Version	Ratenbegrenzung	Hinweise
Genehmigung	1.0.13	Keine spezifische Grenze	Token-Verwaltung
Produkte	1.2.4	10.000 Anrufe/Tag	Suche und Produktdetails
Standorte	1.2.2	1.600 Anrufe/Tag pro Endpunkt	Filialstandorte und Details
Warenkorb	1.2.3	5.000 Anrufe/Tag	Warenkorbartikel hinzufügen/verwalten
Identität	1.2.3	5.000 Anrufe/Tag	Benutzerprofilinformationen

Hinweis: Ratenbegrenzungen werden pro Endpunkt und nicht pro Vorgang erzwungen. Sie können Anrufe bei Bedarf auf mehrere Vorgänge mit demselben Endpunkt verteilen.

🏫 Grundlegender Arbeitsablauf

Richten Sie einen bevorzugten Standort ein :
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]
Produkte suchen und hinzufügen :
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]
Warenkorb und Bestellungen verwalten :
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]

🤝 Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request. Bei größeren Änderungen öffnen Sie bitte zunächst ein Issue, um Ihre Änderungswünsche zu besprechen.

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

⚠️ Haftungsausschluss

Dies ist ein inoffizieller MCP-Server für die Kroger Public API. Er steht in keiner Verbindung zu Kroger und wird von Kroger weder unterstützt noch gesponsert.

Wenn Sie Fragen zur Kroger-API haben, besuchen Sie das Kroger-Entwicklerportal oder lesen Sie die Paketdokumentation „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

Ein FastMCP-Server, der KI-Assistenten wie Claude über das Model Context Protocol nahtlosen Zugriff auf die Lebensmitteleinkaufsfunktionen von Kroger bietet und so die Filialsuche, Produktsuche und Warenkorbverwaltung ermöglicht.

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