Сервер FastMCP, который предоставляет помощникам ИИ, таким как Клод, доступ к функциям покупки продуктов Kroger через протокол Model Context Protocol (MCP). Этот сервер позволяет помощникам ИИ находить магазины, искать продукты, управлять корзинами покупок и получать доступ к полным данным продуктов Kroger через библиотеку python.

. **Docs: ** https://cupofowls.github.io/kroger-api/building-ai-agents/agent-lab — создание ИИ-агента с kroger-mcp и полным справочным инструментом.

Демо

Использование Claude с этим MCP-сервером для поиска магазинов, поиска продуктов и добавления предметов в корзину:

[[Т1]]

Changelog

Обновление с последними изменениями здесь.

Быстрый старт

Предпосылки

Вам понадобятся учетные данные API Kroger (бесплатно на портале разработчиков Kroger). Посетите портал разработчиков Kroger для:

1. Создать учетную запись разработчика 2 Зарегистрируйте свою заявку 3 Возьми [Т2], [Т3] и поставь [Т4].

При первом запуске инструмента, требующего аутентификации пользователя, вам будет предложено авторизовать приложение через веб-браузер.

🛒 Kroger MCP Server 🛍️ – FastMCP for Kroger Shopping

A FastMCP server that provides AI assistants like Claude with access to Kroger’s grocery shopping functionality through the Model Context Protocol (MCP). This server enables AI assistants to find stores, search products, manage shopping carts, and access Kroger’s comprehensive grocery data via the kroger-api python library.

📚 Docs: https://cupofowls.github.io/kroger-api/building-ai-agents/agent-lab — build an AI agent with kroger-mcp, and the full tool reference.

📺 Demo

Using Claude with this MCP server to search for stores, find products, and add items to your cart:

https://github.com/user-attachments/assets/69055f5f-04f5-4ec1-96ac-330aa288fbd1

Changelog

A changelog with recent changes is here.

🚀 Quick Start

Prerequisites

You will need Kroger API credentials (free from Kroger Developer Portal). Visit the Kroger Developer Portal to:

1. Create a developer account
2. Register your application
3. Get your CLIENT_ID, CLIENT_SECRET, and set your REDIRECT_URI

The first time you run a tool requiring user authentication, you’ll be prompted to authorize your app through your web browser. You’re granting permission to your own registered app, not to any third party.

Installation

⚠️ macOS users must use installation Option 2 ⚠️

Option 1: Using uvx with Claude Desktop (Recommended)

Once published to PyPI, you can use uvx to run the package directly without cloning the repository:

Edit Claude Desktop’s configuration file:

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"
      }
    }
  }
}

Benefits of this method:

• Automatically installs the package from PyPI if needed
• Creates an isolated environment for running the server
• Makes it easy to stay updated with the latest version
• Doesn’t require maintaining a local repository clone

Option 2: Using uv with a Local Clone

First, clone locally:

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

Then, edit Claude Desktop’s configuration file:

{
  "mcpServers": {
    "kroger": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/cloned/kroger-mcp",
        "run",
        "kroger-mcp"
      ],
      "env": {