Carrefour Drive 购物助手

一个通过AI助手帮助用户搜索商品、管理购物车、检查送货时段并在Carrefour Drive上订购杂货的MCP服务器。

  • by maximeallanic
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 maximeallanic/mcp-carrefour-drive

使用说明

mcp家乐福驱动

MCP服务器 家乐福大道 --通过人工智能助手搜索产品、管理购物车、查看送货位和订购杂货。

内置于 剧作家 (无头Chrome),因为家乐福不提供公共API。

特性

  • 登录/登出 --使用您的家乐福帐户进行身份验证,会话通过Cookie持久化
  • 店铺选择 --通过邮政编码查找并选择您的家乐福大道
  • 产品搜索 --搜索包含价格、促销和可用性的产品
  • 产品详情 --获取营养事实、成分、过敏原
  • 购物车管理 --添加、删除、更新数量
  • 交付槽位 --查看可用的取货槽并预订一个

注: 此MCP不处理付款。您可以在家乐福网站上手动验证和支付。

安装

npm install mcp-carrefour-drive

或者克隆并构建:

git clone https://github.com/maximeallanic/mcp-carrefour-drive.git
cd mcp-carrefour-drive
npm install
npx playwright install chromium
npm run build

配置

环境变量

变量 描述 必填
CARREFOUR_EMAIL 您的家乐福帐户电子邮件 是(用于登录)
CARREFOUR_PASSWORD 您的家乐福账户密码 是(用于登录)
CARREFOUR_DATA_DIR Cookie/会话数据目录 否(默认值: ~/.carrefour-mcp)

克劳德代码/克劳德桌面

添加到您的 .mcp.json 或 claude_desktop_config.json:

{
  "mcpServers": {
    "carrefour-drive": {
      "command": "npx",
      "args": ["-y", "mcp-carrefour-drive"],
      "env": {
        "CARREFOUR_EMAIL": "your-email@example.com",
        "CARREFOUR_PASSWORD": "your-password"
      }
    }
  }
}

码头工人

由于这使用了无头Chrome,您需要在Docker容器中安装Chromium:

RUN npx playwright install --with-deps chromium

可用工具

工具 说明
login 使用电子邮件/密码登录家乐福
check_login 检查当前是否已登录
logout 退出家乐福
select_store 按邮政编码选择家乐福大道
search_products 搜索产品
get_product_details 获取详细的产品信息(营养、成分)
add_to_cart 将产品添加到购物车
remove_from_cart 从购物车中删除产品
update_cart_quantity 更新购物车中的产品数量
get_cart 查看当前购物车内容和总数
get_available_slots 列出可用的取货时段
select_slot 预留取件槽

示例用法

> Search for "lait demi-écrémé"
> Add the first result to my cart, quantity 2
> What's in my cart?
> Show me available pickup slots for tomorrow

局限性

  • 家乐福的网站可能随时发生变化,导致选择器中断
  • 可能会应用速率限制——服务器在操作之间增加了合理的延迟
  • 无支付自动化(按设计)
  • 需要一个无头Chrome环境(与最小的Docker镜像不兼容)

许可证

麻省理工学院