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 官方设置说明进行操作。

手动设置

你需要在计算机上安装 Node，以便在终端中运行 npx 命令。如果尚未安装 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. 隐身模式：使用带有隐身插件的 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