실험 모델 Context Protocol (MCP) 서버 구현을 통해 AI Assistants는 호주의 주요 슈퍼마켓에서 제품 정보를 검색 할 수 있습니다. Coles 및 Woolworths. 이 서버는 MCP 프로토콜을 통해 제품 검색 기능을 노출하여 제품 가격과 세부 정보를 검색하기 위해 AI 조수가 쉽게 만들 수 있습니다.

데모

Claude 데스크탑 사용

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

특징

-Product Search: Coles와 Woolworths 슈퍼마켓에서 제품을 검색

• ** 가격 비교**: 일관된 형식으로 소매업체의 가격정보를 얻으십시오. -Store Selection: 매장 ID를 사용하여 특정 콜레스 매장 찾기 -Result Limiting: 많은 제품이 검색 결과에서 반환되는 방법을 제어

Claude Desktop, Cursor 및 기타 고객을 위한 빠른 시작

1. Clone 이 저장소

2. 프로젝트 디렉토리에 Navigate

3. 필수품 설치

4. MCP 클라이언트를 구성하여 이 서버 (MCP 클라이언트와 통합 참조)

설치

# 필수품

1. 파이썬 3.8 이상
2. uv 패키지 관리자

uv 설치

uv는 빠른 파이썬 패키지 설치 및 해결자입니다.

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