Groceries MCP Server

基本能力

产品定位

Groceries MCP Server 是一个用于不同杂货供应商API的MCP服务器，主要功能包括杂货搜索和购物车更新。

核心功能

• 自动购物车创建：根据提供的列表自动添加商品到购物车。
• 杂货查找：通过供应商API查找杂货。

适用场景

• 杂货购物自动化
• 批量添加商品到购物车
• 杂货商品搜索

工具列表

1. add_items_to_cart
2. 功能：将杂货添加到购物车。
3. 输入：items（列表[CartItemScheam]）：要添加到购物车的商品。
4. 返回：更新后的购物车。
5. search
6. 功能：在供应商处查找商品。
7. 输入：item（字符串）：要查找的商品。
8. 返回：与搜索词对应的商品列表。

常见问题解答

• 如何获取供应商API密钥和账户ID？
• 登录供应商网站（如Rami Levy），在开发者工具中执行提供的JavaScript代码以获取所需的环境变量。

使用教程

使用依赖

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,
});

1. 将打印的值替换为环境变量。

安装教程

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

调试方式

• 使用Claude Desktop时，将以下内容添加到claude_desktop_config.json中：

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

• Docker构建：

docker build -t mcp-groceries-server .

许可证

该项目遵循 MIT 开源许可条款。