Coles and Woolworths MCP Server

Servidor MCP de Coles y Woolworths

Una implementación experimental de un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA buscar información de productos de los principales supermercados de Australia: Coles y Woolworths. Este servidor expone la funcionalidad de búsqueda de productos a través del protocolo MCP, facilitando que los asistentes de IA recuperen precios y detalles de productos.

Demo

Uso con Claude Desktop

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

Características

• Búsqueda de Productos: Busca productos tanto en los supermercados Coles como Woolworths
• Comparación de Precios: Obtén información de precios de ambos minoristas en un formato consistente
• Selección de Tienda: Busca en tiendas específicas de Coles usando IDs de tienda
• Límite de Resultados: Controla cuántos productos se devuelven en los resultados de búsqueda

Inicio Rápido para Claude Desktop, Cursor y otros clientes

1. Clona este repositorio

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

2. Navega al directorio del proyecto

cd coles-woolies-mcp

3. Instala los prerrequisitos

4. Configura tu cliente MCP para usar este servidor (consulta Integración con Clientes MCP)

Instalación

Prerrequisitos

1. Python 3.8 o superior
2. El gestor de paquetes uv

Instalando uv

uv es un instalador y resolutor de paquetes de Python rápido. Para instalarlo:

macOS/Linux:

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

Windows:

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

Configuración

1. Clona el repositorio y navega al directorio del proyecto
2. Usa uv para instalar las dependencias:

# Install dependencies
uv pip install fastmcp requests python-dotenv

Configuración

El servidor utiliza las siguientes variables de entorno:

• COLES_API_KEY: Clave API para acceder a la API de Coles (requerida para búsquedas de productos de Coles)

Puedes configurar estas variables en un archivo .env en el directorio del proyecto.

Ejecutando el Servidor

Para ejecutar el servidor MCP de Coles y Woolworths directamente usando uv:

uv run main.py

Por defecto, el servidor se ejecuta con transporte stdio para la integración con clientes MCP.

Integración con Clientes MCP

Configuración de Claude Desktop

Para usar el servidor MCP de Coles y Woolworths con Claude Desktop:

1. Localiza tu archivo de configuración de Claude Desktop (generalmente claude_desktop_config.json)
2. Agrega la siguiente configuración a la sección mcpServers:

{
  "mcpServers": {
    "coles-woolies-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "requests",
        "--with", 
        "python-dotenv",
        "fastmcp",
        "run",
        "/full/path/to/coles-woolies-mcp/main.py"
      ]
    }
  }
}

Reemplaza /full/path/to/coles-woolies-mcp/main.py con la ruta absoluta a tu archivo main.py.

3. Reinicia Claude Desktop para que los cambios surtan efecto

Configuración de Cursor IDE

Para integrar con Cursor IDE:

1. Abre tu archivo de configuración de Cursor
2. Agrega lo siguiente a la sección mcpServers:

{
  "mcpServers": {
    "coles-woolies-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "requests",
        "--with", 
        "python-dotenv",
        "fastmcp",
        "run",
        "/full/path/to/coles-woolies-mcp/main.py"
      ]
    }
  }
}

Herramientas Disponibles

El servidor MCP de Coles y Woolworths expone las siguientes herramientas:

• get_coles_products: Busca productos en los supermercados Coles con selección opcional de tienda
• get_woolworths_products: Busca productos en los supermercados Woolworths

Ejemplo de Uso en Claude

Puedes usar las herramientas en Claude de la siguiente manera:

Could you check the price of Cadbury chocolate at both Coles and Woolworths?

Claude utilizará entonces las herramientas apropiadas para buscar los productos y devolver los resultados.

Requisitos

• Python 3.8 o superior
• Paquete fastmcp
• Paquete requests
• Paquete python-dotenv
• Cliente compatible con MCP (Claude Desktop, Cursor, etc.)