🚀 食品杂货 MCP 服务器

本项目是一个食品杂货 MCP 服务器，可实现自动购物车创建和食品杂货搜索功能，为用户提供便捷的食品杂货采购服务。

✨ 主要特性

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

📦 安装指南

环境变量配置

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 中使用此 MCP 服务器，请在您的 claude_desktop_config.json 中添加以下内容：

UV

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

💻 使用示例

基础用法

add_items_to_cart

# 将商品添加到购物车中
# 输入：
#   - `items`(list[CartItemScheam]): 要添加到购物车中的商品
# 输出：更新后的购物车

search

# 在 vendor 中查找商品
# 输入：
#   - `item` (string): 要查找的商品
# 输出：与搜索词对应的商品列表

📚 详细文档

工具说明

1. add_items_to_cart
   • 将商品添加到购物车中。
   • 输入：
     • items(list[CartItemScheam]): 要添加到购物车中的商品
   • 输出：更新后的购物车
2. search
   • 在 vendor 中查找商品。
   • 输入：
     • item (string): 要查找的商品
   • 输出：与搜索词对应的商品列表

构建

Docker 构建命令：

docker build -t mcp-groceries-server .

📄 许可证

此 MCP 服务器根据 MIT License 分发。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT License 的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。