Groceries MCP

🚀 食品雜貨 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 文件。