全食MCP服务器
一 主控程序 自动从亚马逊全食超市订购杂货的服务器。用途 剧作家 用于浏览器自动化，并公开用于搜索产品、管理购物车和添加商品的工具。
演示
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 chromium2.连接到克劳德代码
从项目目录启动Claude Code：
cd whole-foods-mcp
claude包括 .mcp.json 自动配置MCP服务器，无需额外设置。
3.登录亚马逊
首次使用时，您需要验证您的亚马逊会话：
- 在克劳德代码中，说： “登录亚马逊”
- 浏览器窗口将打开亚马逊登录页面
- 使用您的凭据登录并完成任何2FA提示
- 确保你的全食超市送货地址已被选中（查看亚马逊网站左上角）
- 说： “保存会话” --这将保留您的登录信息，因此您不必重复登录
您的会话保存在本地 .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 | 清除所有购物车商品 |
运作原理
- 通过Playwright（无头Chrome/Chromium）维护经过身份验证的亚马逊会话
- 搜索 使用亚马逊全食超市搜索查找产品
- 加入购物车 直接获取新的add-to-cart令牌的产品页面，然后张贴到亚马逊的cart API
- 基于重量的物品（农产品、新鲜肉类）是自动处理的——产品页面总是有添加到购物车的有效载荷
工具设计
- 搜索是只读的 —
search_whole_foods切勿触碰购物车 - 添加到购物车与搜索无关 —
add_to_cart只需要一个ASIN，它从产品页面获取自己的令牌 - 产品详细信息包括屏幕截图 —
get_product_details返回结构化文本和屏幕截图，以便Claude可以看到产品图像 - 无散装工具 --Claude通过调用
add_to_cart多次通过代理