good-eggs

Good Eggs MCP サーバー

Playwright を使用した Good Eggs の食料品購入自動化用 MCP サーバーです。食料品を検索し、お気に入りを管理し、商品をカートに追加して、過去の注文を確認できます。

機能

• 食料品を検索 - Good Eggs の食料品を検索します（お気に入り登録状況も含みます）
• お気に入りを管理 - お気に入り商品の取得、追加、削除を行います
• 商品詳細を取得 - 商品の詳細情報を確認します
• ショッピングカート - ショッピングカートの表示、商品の追加、削除を行います
• 無料商品を検索 - ホームページと fresh-picks で価格が $0.00 の商品を検索します
• 過去の注文 - 注文履歴を確認して、商品を再注文します

ツール

ツール	説明
search_for_grocery	キーワードで食料品を検索します（お気に入りも含みます）
get_favorites	お気に入り／保存済みの食料品を取得します
get_grocery_details	特定商品の詳細情報を取得します
add_to_cart	商品をショッピングカートに追加します
get_cart	ショッピングカートの内容を表示します
remove_from_cart	商品をショッピングカートから削除します
search_for_freebie_groceries	ホームページと fresh-picks で無料商品（$0.00）を検索します
get_list_of_past_order_dates	過去の注文日を取得します
get_past_order_groceries	指定した過去の注文の商品を取得します
add_favorite	商品をお気に入りに追加します
remove_favorite	商品をお気に入りから削除します

セットアップ

前提条件

• Node.js 18+
• Good Eggs アカウント（goodeggs.com で作成してください）

環境変数

変数	必須	説明	デフォルト
GOOD_EGGS_USERNAME	はい	Good Eggs アカウントのメールアドレス	-
GOOD_EGGS_PASSWORD	はい	Good Eggs アカウントのパスワード	-
HEADLESS	いいえ	ヘッドレスモードでブラウザーを実行します	true
TIMEOUT	いいえ	ブラウザー操作のタイムアウト（ms）	30000

Claude Desktop

Good Eggs アカウントのログイン情報を用意してください。

続いて、以下のセットアップ手順に進んでください。MCP サーバーを初めて使用する場合は、Claude Desktop アプリケーションを用意し、MCP 公式セットアップ手順に従ってください。

手動セットアップ

ターミナルで npx コマンドを実行できるように、お使いのマシンで Node が動作している必要があります。Node がインストールされていない場合は、nodejs.org からインストールできます。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json ファイルを変更して、以下を追加してください。

{
  "mcpServers": {
    "good-eggs": {
      "command": "npx",
      "args": ["-y", "good-eggs-mcp-server"],
      "env": {
        "GOOD_EGGS_USERNAME": "[email protected]",
        "GOOD_EGGS_PASSWORD": "your-password"
      }
    }
  }
}

Claude Desktop を再起動すれば、準備完了です！

使用例

食料品を検索する

"Search for organic apples"
"Find gluten-free bread"
"Look for chicken breast"

お気に入りを表示して追加する

"Show me my favorite items"
"What are my saved groceries?"

商品をカートに追加する

"Add 2 of those apples to my cart"
"Put the organic milk in my basket"

カートを表示する

"What's in my cart?"
"Show me my basket"

お得な商品を確認する

"What deals are available today?"
"Find any free items"

過去の注文から再注文する

"Show me my past orders"
"What did I order on January 3rd?"

動作の仕組み

この MCP サーバーは Playwright を使用して、Good Eggs のブラウザーセッションを自動化します。

1. 初回のツール使用時：ブラウザーを起動し、Good Eggs アカウントにログインします
2. ブラウザーセッションの維持：以降のすべてのツール呼び出しで、同じログイン済みセッションを再利用します
3. スマートナビゲーション：ナビゲーションを最小限に抑えるため、ツールはすでに正しいページにいるかを確認します
4. ステルスモード：ボット検出を回避するため、stealth プラグインを備えた playwright-extra を使用します

開発

# Install dependencies
npm run install-all

# Run in development mode
npm run dev

# Build
npm run build

# Run tests
npm test

# Lint
npm run lint

プロジェクト構成

good-eggs/
├── local/                 # Local server implementation
│   └── src/
│       └── index.ts       # Entry point with env validation
├── shared/                # Shared business logic
│   └── src/
│       ├── server.ts      # GoodEggsClient with Playwright automation
│       ├── tools.ts       # MCP tool definitions
│       ├── types.ts       # TypeScript types
│       └── logging.ts     # Logging utilities
├── tests/                 # Test suites
├── package.json           # Root workspace config
└── README.md

セキュリティに関する注意事項

• Good Eggs の認証情報は、アカウントへのログインにのみ使用されます
• ブラウザーセッションはお使いのマシン上でローカルに実行されます
• 認証情報がサードパーティのサービスに送信されることはありません
• 認証情報をハードコードするのではなく、環境変数を使用することを検討してください

制限事項

• お住まいの地域で配送サービスを利用できる、有効な Good Eggs アカウントが必要です
• Good Eggs がウェブサイトを更新すると、ブラウザー自動化が失敗することがあります
• 一部の操作（お気に入り、過去の注文）にはアカウントへのログインが必要です

ライセンス

MIT