Coles Woolworths MCP Server

🚀 コールズとウールウォーズのMCPサーバー

このプロジェクトは、実験的なモデルコンテキストプロトコル（MCP）サーバーの実装です。AIアシスタントがオーストラリアの主要なスーパーマーケットであるコールズとウールウォーズから商品情報を検索できるようにします。このサーバーは、MCPプロトコルを通じて商品検索機能を公開し、AIアシスタントが商品の価格と詳細を簡単に取得できるようにします。

🚀 クイックスタート

Claude Desktop、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クライアント統合のためにstdioトランスポートで実行されます。

💻 使用例

デモ

Claude Desktopでの使用

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

Claudeでの使用例

Claudeで以下のようにツールを使用できます。

コールズとウールウォーズの両方でキャドバリーチョコレートの価格を調べてくれますか？

Claudeは適切なツールを使用して商品を検索し、結果を返します。

📚 ドキュメント

MCPクライアントとの統合

Claude Desktopの設定

Claude DesktopでコールズとウールウォーズのMCPサーバーを使用するには：

1. Claude Desktopの設定ファイル（通常は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 Desktopを再起動します。

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：ウールウォーズスーパーマーケットの商品を検索します。

要件

• Python 3.8以上
• fastmcpパッケージ
• requestsパッケージ
• python-dotenvパッケージ
• MCP互換クライアント（Claude Desktop、Cursorなど）