AI导哈

食品杂货自动化订购服务

通过浏览器自动化技术实现从Amazon Whole Foods Market自动搜索商品、管理购物车和下单的MCP服务器。

  • by benjiebob
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 benjiebob/whole-foods-mcp

使用说明

全食MCP服务器

一 主控程序 自动从亚马逊全食超市订购杂货的服务器。用途 剧作家 用于浏览器自动化，并公开用于搜索产品、管理购物车和添加商品的工具。

适用于 克劳德代码 和 克劳德桌面 （通过MCPB）

演示

https://github.com/user-attachments/assets/8ee0c000-6289-4b2f-86e4-2ebbe237561c

先决条件

  • Python 3.11+
  • 紫外线 --Python包管理器。安装方法 curl -LsSf https://astral.sh/uv/install.sh | sh
  • 亚马逊帐户 全食超市为您的地址设置了配送服务

入门指南

1.克隆并安装

git clone https://github.com/benjiebob/whole-foods-mcp.git
cd whole-foods-mcp
uv sync
uv run playwright install chromium

2.连接到克劳德代码

从项目目录启动Claude Code：

cd whole-foods-mcp
claude

包括 .mcp.json 自动配置MCP服务器，无需额外设置。

3.登录亚马逊

首次使用时，您需要验证您的亚马逊会话：

  1. 在克劳德代码中，说： “登录亚马逊”
  2. 浏览器窗口将打开亚马逊登录页面
  3. 使用您的凭据登录并完成任何2FA提示
  4. 确保你的全食超市送货地址已被选中（查看亚马逊网站左上角）
  5. 说： “保存会话” --这将保留您的登录信息，因此您不必重复登录

您的会话保存在本地 .browser_state/ （忽略了）。只有当会话过期时（通常每隔几周），您才需要重新登录。

注： 如果您安装了Chrome，登录窗口将使用Chrome（因此您的密码管理器和扩展程序可用）。否则，它将退回到Playwright捆绑的Chromium。

4.开始购物

现在你可以使用自然语言了：

  • “寻找有机燕麦奶”
  • “把5根香蕉和一打鸡蛋加到我的购物车里”
  • “我的车里有什么？”
  • “从我的购物车中删除cheerios”

克劳德桌面（MCPB）

您还可以将其安装为Claude Desktop的一键扩展：

npm install -g @anthropic-ai/mcpb
mcpb pack . whole-foods-mcp.mcpb

然后双击 whole-foods-mcp.mcpb 安装在Claude Desktop中。

工具

工具 说明
login 打开浏览器登录亚马逊
save_session 将会话Cookie持久化到磁盘
search_whole_foods 搜索产品--返回ASIN、标题、价格、尺寸
get_product_details 深入了解产品——完整描述、成分、图片截图
add_to_cart 通过ASIN添加产品（获取新代币的产品页面）
view_cart 查看当前购物车内容
remove_from_cart 通过ASIN删除项目
clear_cart 清除所有购物车商品

运作原理

  1. 通过Playwright（无头Chrome/Chromium）维护经过身份验证的亚马逊会话
  2. 搜索 使用亚马逊全食超市搜索查找产品
  3. 加入购物车 直接获取新的add-to-cart令牌的产品页面，然后张贴到亚马逊的cart API
  4. 基于重量的物品（农产品、新鲜肉类）是自动处理的——产品页面总是有添加到购物车的有效载荷

工具设计

  • 搜索是只读的 — search_whole_foods 切勿触碰购物车
  • 添加到购物车与搜索无关 — add_to_cart 只需要一个ASIN，它从产品页面获取自己的令牌
  • 产品详细信息包括屏幕截图 — get_product_details 返回结构化文本和屏幕截图，以便Claude可以看到产品图像
  • 无散装工具 --Claude通过调用 add_to_cart 多次通过代理

相关 MCP