Экспериментальная реализация сервера Model Context Protocol (MCP), которая позволяет помощникам ИИ искать информацию о продукте из крупных супермаркетов Австралии: Coles и Woolworths. Этот сервер раскрывает функциональность поиска продуктов через протокол MCP, что позволяет помощникам ИИ легко получать цены на продукты и детали.

Демо

Использование с Claude Desktop

[[Т0]]

Особенности

Поиск товаров: поиск товаров в супермаркетах Coles и Woolworths Сравнение цен: Получите информацию о ценах от обоих ритейлеров в согласованном формате Выбор магазинов: Поиск конкретных магазинов Coles с использованием идентификаторов магазинов ** Ограничение результатов **: Контролируйте, сколько продуктов возвращается в результатах поиска

Быстрый старт для Claude Desktop, Cursor и других клиентов

1. Клонировать это хранилище

2. Перейдите в каталог проекта

3. Установить предпосылки

4.Настройте клиент MCP для использования этого сервера (см. Интеграция с клиентами MCP).

##Установка

Предпосылки

1 Python 3.8 или выше 2. менеджер пакетов uv

###Установка uv

uv является быстрым установщиком и разрешителем пакетов Python.

Coles and Woolworths MCP Server

An experimental Model Context Protocol (MCP) server implementation that allows AI assistants to search for product information from Australia’s major supermarkets: Coles and Woolworths. This server exposes product search functionality through the MCP protocol, making it easy for AI assistants to retrieve product pricing and details.

Demo

Use with Claude Desktop

https://github.com/user-attachments/assets/0af3b07a-578a-4112-acfe-e7a7eee31161

Features

• Product Search: Search for products at both Coles and Woolworths supermarkets
• Price Comparison: Get pricing information from both retailers in a consistent format
• Store Selection: Search specific Coles stores using store IDs
• Result Limiting: Control how many products are returned in search results

Quick Start for Claude Desktop, Cursor, and other clients

1. Clone this repository

git clone https://github.com/hung-ngm/coles-woolworths-mcp-server.git

2. Navigate to the project directory

cd coles-woolies-mcp

3. Install the prerequisites

4. Configure your MCP client to use this server (see Integrating with MCP Clients)

Installation

Prerequisites

1. Python 3.8 or higher
2. The uv package manager

Installing uv

uv is a fast Python package installer and resolver. To install:

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Setup

1. Clone the repository and navigate to the project directory
2. Use uv to install dependencies:

# Install dependencies
uv pip install fastmcp requests python-dotenv

Configuration

The server uses the following environment variables:

• COLES_API_KEY: API key for accessing the Coles API (required for Coles product searches)

You can set these variables in a .env file in the project directory.

Running the Server

To run the Coles and Woolworths MCP server directly using uv:

uv run main.py

By default, the server runs with stdio transport for MCP client integration.

Integrating with MCP Clients

Claude Desktop Configuration

To use the Coles and Woolworths MCP server with Claude Desktop:

1. Locate your Claude Desktop configuration file (usually claude_desktop_config.json)
2. Add the following configuration to the mcpServers section:

{
  "mcpServers": {
    "coles-woolies-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "requests",
        "--with", 
        "python-dotenv",
        "fastmcp",
        "run",