Mercadona MCP服务器
一 MCP服务器 为了 Mercadona网上商店. 该服务器为人工智能助手（如Claude或Cursor）提供了管理杂货购物的超能力：搜索产品、构建购物车和分析历史记录。
______________________________________________________________________
🚀 快速开始
将此添加到您的 claude_desktop_config.json 或光标MCP设置。无需手动安装！
{
"mcpServers": {
"mercadona": {
"command": "npx",
"args": ["-y", "mercadona-mcp"]
}
}
}首次运行： 你需要登录。只需询问你的AI： “让我登录梅尔卡多纳” 并按照它给你的说明进行操作（它使用 login 工具）。______________________________________________________________________
✨ 能力
🛒 产品搜索和详细信息
- 搜索：按名称查找产品（例如“leche”、“hummus”）。服务器过滤掉不可用的项目。
- 详情：获取完整的规格、包装信息和营养事实。
📦 完成购物车管理
- 查看购物车：查看您购物篮中的当前商品和总价。
- 添加/删除：添加单个项目或 批量添加 同时处理多个项目。
- 清除：一次性清空整个购物车。
🧠 智能购物车（人工智能驱动）
- 预测性购物：The
calculate_smart_cart该工具分析您去年的订单，找出您定期购买的商品（例如每两周一次），并检查您是否需要补货。 - 资源：随时查看结果，网址为
mercadona://smart_cart. - 增量订单同步：每次运行智能购物车都会首先检查Mercadona是否有新的可用订单，并且只下载尚未在本地缓存的订单。
- 更快的重新计算：以前下载的订单行从本地缓存中重复使用，以避免每次运行时重复调用API。
📜 订单历史
- 最近订单：列出您最近购买的商品。
- 资源：在以下位置获取快速JSON转储
mercadona://recent_orders.
⚡ 实时资源
服务器暴露 MCP资源:
| 资源 | 描述 |
|---|---|
mercadona://cart | 当前购物车的实时JSON视图。 |
mercadona://smart_cart | 智能购物车算法的最新建议。 |
mercadona://recent_orders | 你最近20个订单的清单。 |
______________________________________________________________________
🔐 认证
此服务器需要有效的Mercadona会话(MO-user 令牌）和位置数据(postal_code, warehouse_id)工作。
选项A：人工智能辅助（推荐）
- 问：“让我登录梅尔卡多纳。”
- 跟随：AI将使用
login工具来指导你。它通常涉及：
- 打开浏览器进入登录页面。 - 您手动登录。 - AI从浏览器存储中获取凭据，并将其严格保存到您的本地计算机(~/.mercadona_auth.json).
选项B：手动设置
如果你更喜欢自己拿代币：
- 登录 商店.
- 打开 开发人员工具（F12） > 应用.
- 本地存储：复制的值 MO-user. - Cookie：查找 __mo_da 并对其进行解码（它包含您的仓库/压缩包）。
- 创建
~/.mercadona_auth.json:
{
"local_storage": {
"MO-user": "{\"token\": \"...\", \"uuid\": \"...\"}"
},
"location": {
"postal_code": "46001",
"warehouse_id": "4115"
}
}______________________________________________________________________
🛠️ 配置
您可以使用环境变量覆盖默认的身份验证文件位置：
"env": {
"MERCADONA_AUTH_FILE": "/absolute/path/to/my_auth.json"
}智能购物车订单缓存
为了支持增量订单同步，服务器将按客户UUID保存订单历史记录：
- 路径:
~/.mercadona_orders_cache_.json - 行为:
- 在每一个 calculate_smart_cart 调用时，服务器会获取最近的订单，并只追加看不见的订单 order.id 条目。 - 缓存订单包括订单元数据+推荐引擎使用的准备订单行。 - 建议输出包括同步统计数据(new order(s) downloaded 和 cached total).
- 为什么这很重要:
- 加快重复的智能购物车呼叫。 - 减少到订单端点的重复网络流量。 - 在两次运行之间保持历史信号稳定，同时仍在吸收新的购买。
👩💻 发展
要从源代码运行，请执行以下操作：
git clone https://github.com/aganoob/mercadona-mcp
cd mercadona-mcp
npm install
npm run build
npm start传统Python
原始Python实现可在 legacy_python/.