Kroger MCP Server

🛒 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“ .

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.

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

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