Coles Woolworths MCP Server

🚀 科爾斯和伍爾沃斯MCP服務器

這是一個實驗性的模型上下文協議（MCP）服務器實現，它允許AI助手從澳大利亞主要超市——科爾斯（Coles）和伍爾沃斯（Woolworths）搜索產品信息。該服務器通過MCP協議提供產品搜索功能，方便AI助手獲取產品價格和詳細信息。

🚀 快速開始

適用於Claude桌面版、Cursor及其他客戶端

1. 克隆此倉庫

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

2. 進入項目目錄

cd coles-woolies-mcp

3. 安裝先決條件
4. 配置你的MCP客戶端以使用此服務器（請參閱與MCP客戶端集成）

✨ 主要特性

• 產品搜索：在科爾斯和伍爾沃斯超市搜索產品
• 價格比較：以統一格式獲取兩家零售商的定價信息
• 店鋪選擇：使用店鋪ID搜索特定的科爾斯店鋪
• 結果限制：控制搜索結果中返回的產品數量

📦 安裝指南

先決條件

1. Python 3.8 或更高版本
2. uv 包管理器

安裝uv

uv 是一個快速的Python包安裝程序和解析器。安裝方法如下：

macOS/Linux：

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

Windows：

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

環境搭建

1. 克隆倉庫並進入項目目錄
2. 使用 uv 安裝依賴項：

# 安裝依賴項
uv pip install fastmcp requests python-dotenv

📚 詳細文檔

配置

服務器使用以下環境變量：

• COLES_API_KEY：訪問科爾斯API的API密鑰（科爾斯產品搜索必需）

你可以在項目目錄的 .env 文件中設置這些變量。

運行服務器

要直接使用 uv 運行科爾斯和伍爾沃斯MCP服務器，請執行以下命令：

uv run main.py

默認情況下，服務器使用標準輸入輸出傳輸進行MCP客戶端集成。

與MCP客戶端集成

Claude桌面版配置

要在Claude桌面版中使用科爾斯和伍爾沃斯MCP服務器，請按以下步驟操作：

1. 找到你的Claude桌面版配置文件（通常為 claude_desktop_config.json）
2. 在 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"
      ]
    }
  }
}

將 /full/path/to/coles-woolies-mcp/main.py 替換為你的 main.py 文件的絕對路徑。 3. 重啟Claude桌面版使更改生效

Cursor IDE配置

要與Cursor IDE集成，請按以下步驟操作：

1. 打開你的Cursor配置文件
2. 在 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"
      ]
    }
  }
}

可用工具

科爾斯和伍爾沃斯MCP服務器提供以下工具：

• get_coles_products：在科爾斯超市搜索產品，可選擇特定店鋪
• get_woolworths_products：在伍爾沃斯超市搜索產品

在Claude中的使用示例

你可以在Claude中這樣使用這些工具：

能否查詢一下吉百利巧克力在科爾斯和伍爾沃斯的價格？

Claude隨後會使用相應的工具搜索產品並返回結果。

要求

• Python 3.8 或更高版本
• fastmcp 包
• requests 包
• python-dotenv 包
• 兼容MCP的客戶端（Claude桌面版、Cursor等）

🔍 演示

在Claude桌面版中使用

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