sethbroughton/kroger-mcp-cf

Kroger MCP Server

A remote MCP (Model Context Protocol) server that provides AI assistants with access to Kroger's grocery shopping API, deployed on Cloudflare Workers.

Features

• 🛒 Search Kroger Locations - Find stores near any zip code
• 🔍 Product Search - Search for products across Kroger stores
• 📦 Product Details - Get detailed information about specific products
• ☁️ Cloudflare Workers - Deployed on edge for low latency
• 🔄 CI/CD Pipeline - Automated testing and deployment via GitHub Actions

Deployed URL

Your MCP server is available at: https://kroger-mcp-cf.pantry-pal.workers.dev/sse

Connect to Claude Desktop

Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "kroger": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://kroger-mcp-cf.pantry-pal.workers.dev/sse"
      ]
    }
  }
}

Restart Claude Desktop and you'll have access to Kroger shopping tools!

Available Tools

1. search_locations - Find Kroger stores near a zip code
2. search_products - Search for products by name or keyword
3. get_product_details - Get detailed product information

Development

# Install dependencies
npm install

# Run locally
npm run dev

# Deploy to Cloudflare
npm run deploy

# Type check
npm run type-check

# Format code
npm run format

CI/CD

This project uses GitHub Actions for automated testing and deployment:

• Tests run on every push and pull request
• Automatic deployment to Cloudflare Workers on main branch
• Protected main branch requires passing tests

Setup

1. Get Kroger API credentials from Kroger Developer Portal
2. Add secrets to Cloudflare Workers:

   wrangler secret put KROGER_CLIENT_ID
   wrangler secret put KROGER_CLIENT_SECRET
   

License

MIT