Groceries MCP Server

Groceries MCP 服务

---

适用于不同 Groceries 供应商 API 的 MCP 服务，可搜索杂货并更新购物车。

功能

• 自动创建购物车：根据提供的清单将商品添加到购物车
• 杂货查询：通过供应商 API 查询杂货

工具

1. add_items_to_cart

• 将杂货添加到购物篮。
• 输入：
  • items(list[CartItemScheam])：要添加到购物车的商品
• 返回：已更新的购物车

2. search
   • 在供应商处查询商品
   • 输入：
     • item (string)：要查询的商品
   • 返回：与搜索词对应的商品列表

设置

提取环境变量

Rami Levy

1. 登录 Rami Levy 网站
2. 在开发者工具中（按 F12 打开）执行：

const state = JSON.parse(localStorage.ramilevy);
console.log({
    "VENDOR_ACCOUNT_ID": state.authuser.user.id,
    "VENDOR_API_KEY": state.authuser.user.token,
});

3. 将环境变量替换为输出的值

本地使用

1. 使用 env.template 更新 .env 文件（需要 Gemini）
2. 更新 grocery.txt
3. 运行 make compile start_agent

在 Claude Desktop 中使用

要在 Claude Desktop 中使用，请将以下内容添加到 claude_desktop_config.json：

UV

{
  "mcpServers": {
    "groceries": {
      "command": "uv",
      "args": [
        "run",
        "mcp-groceries-server",
        "--vendor",
        vendorName # rami-levy, keshet e.g
      ],
      "env":{
        "VENDOR_API_KEY": "<YOUR_API_TOKEN>",
        "VENDOR_ACCOUNT_ID": "<VENDOR_ACCOUNT_ID>"
      }
    }
  }
}

构建

Docker 构建：

docker build -t mcp-groceries-server .

许可证

此 MCP 服务采用 MIT 许可证。这意味着你可以自由使用、修改和分发本软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。