実験的なモデルコンテキストプロトコル(MCP)サーバーの実装により、AIアシスタントはオーストラリアの主要なスーパーマーケットから製品情報を検索することができます。コールとウールワース。 このサーバーは、MCP プロトコルを介して製品検索機能を公開し、AI アシスタントが製品価格と詳細を取得できるようにします。

デモ

##Claudeデスクトップで使用

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

##特徴

• 製品検索:コールとウールワースの両方のスーパーマーケットで製品を検索
• 価格比較: 一貫性のある形式で両方の小売店から価格情報を取得する
• ストア選択:ストアIDを使用して特定のコールストアを検索 -結果制限:検索結果にどれだけ多くの製品が返されるかを制御する

##Claudeデスクトップ、カーソル、およびその他のクライアントのクイックスタート

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