Shufersal MCP

🚀 Shufersal MCP Server

このサーバーは、Puppeteerを使用してShufersalウェブサイトに自動ショッピング機能を提供するModel Context Protocolサーバーです。LLMがShufersalのオンラインショッピングプラットフォームと対話し、商品を検索し、買い物リストを作成し、カートに商品を追加できるようになります。

✨ 主な機能

• 商品検索：Shufersalの商品カタログを検索でき、ログインユーザーはパーソナライズされた結果を取得できます。
• カート管理：Shufersalのショッピングカートに商品を追加できます。
• ブラウザ自動化：Shufersalウェブサイトとシームレスに対話できます。
• 買い物リスト管理：ウェブリンク（例：レシピリンク）から構造化された買い物リストを作成できます。
• コンソール監視：ブラウザ自動化のコンソールログを追跡できます（デバッグ用）。

🚀 クイックスタート

1. 買い物リストの作成：create_shopping_list_tableを使用して、リクエストまたはレシピリンクから買い物リストを作成します。
2. Shufersalのオープン：open_shufersalを使用してShufersalウェブサイトに移動します（ログインが必要です）。
3. 商品の検索：search_shufersalを使用して、買い物リストのアイテムに一致する商品を検索します。
4. カートへの追加：add_to_shufersal_cartを使用して、見つかった商品をショッピングカートに追加します。

📚 ドキュメント

ツール

• open_shufersal

  • Shufersalウェブサイトを開き、ショッピングを準備します（ユーザーログインが必要です）。
  • 入力: hasCreatedShoppingList (boolean): 事前に買い物リストが作成されているかどうか。

• search_shufersal

  • Shufersalウェブサイトで商品を検索します（結果は購入履歴でソートされます）。
  • 入力: query (string): 商品検索クエリ（例：'milk', 'bread', 'tomatoes'）。

• add_to_shufersal_cart

  • 商品をショッピングカートに追加します（検索後に使用する必要があります）。
  • 入力:
    • product_id (string): 検索結果の商品ID。
    • sellingMethod (string): 検索結果の販売方法。
    • qty (number): カートに追加する数量。
    • comment (string, オプション): 商品に関するオプションのコメント。

レシピリンクを貼り付けるための追加ツール

• read_webpage_content

  • ウェブページの内容を読み取り、Markdown形式に変換します。
  • 入力: url (string): 読み取るウェブページのURL。

• create_shopping_list_table

  • レシピの材料からMarkdown形式の買い物リストテーブルを作成します。
  • 入力: recipe (array): 名前、数量、測定単位、およびオプションのブランドを含むレシピ材料の配列。

リソース

このサーバーは以下へのアクセスを提供します。

1. コンソールログ (console://logs)

• テキスト形式のブラウザコンソール出力。
• ブラウザ自動化のすべてのコンソールメッセージを含みます。

🔧 設定

Shufersal MCPサーバーを使用するためのClaude Desktopの設定は以下の通りです。

{
  "mcpServers": {
    "shufersal": {
      "command": "node",
      "args": ["<path/to/shufersal-mcp>/dist/index.js"],
    }
  }
}

カスタムユーザーデータディレクトリを使用する場合：

{
  "mcpServers": {
    "shufersal": {
      "command": "node",
      "args": ["<path/to/shufersal-mcp>/dist/index.js", "--user-data-dir=<path/to/custom/user/data>"],
    }
  }
}

Windowsの場合：

{
  "mcpServers": {
    "shufersal": {
      "command": "<path/to/node>",
      "args": ["<path/to/shufersal-mcp>/dist/index.js"],
    }
  }
}

⚠️ セキュリティに関する注意

重要: このツールはShufersalウェブサイトとのブラウザ対話を自動化し、ブラウザデータをローカルに保存します。以下の点に注意してください。

• ブラウザセッションデータは./puppeteer-user-data/に保存されます（gitから除外されます）。
• 初回使用時にShufersalにログインすると、ツールはセッションデータをユーザーデータディレクトリに保存します。
• 信頼できるMCPクライアントでのみこのツールを使用してください。

🔧 開発

ビルド

npm run build

開発モード

npm run watch

リント

npm run lint
npm run lint:fix

📄 ライセンス

このMCPサーバーはMITライセンスの下でライセンスされています。これは、MITライセンスの条件に従って、ソフトウェアを自由に使用、変更、配布できることを意味します。