MCP Food Search

🚀 雜貨搜索MCP服務器

這是一個MCP（模型上下文協議）服務器，具備搜索雜貨價格和營養信息的能力。該服務器允許AI代理在不同的雜貨店中搜索食品、比較價格並分析營養成分。

🚀 快速開始

本服務器允許AI代理在不同雜貨店搜索食品、比較價格以及分析營養成分。

運行MCP服務器

使用以下命令啟動服務器：

python -m grocery_search_mcp.server

或者使用腳本入口點啟動：

grocery-search-mcp

測試實現

運行測試腳本以驗證功能：

python test_server.py

✨ 主要特性

• 產品搜索：在支持的商店中按名稱搜索雜貨商品。
• 價格比較：獲取食品的當前定價信息。
• 營養分析：獲取蛋白質、卡路里和其他宏觀營養信息。
• 每美元蛋白質排名：根據每美元的蛋白質含量自動對產品進行排名。
• 商店支持：目前支持Trader Joe's（更多商店即將支持）。

📦 安裝指南

1. 克隆倉庫：

git clone <repository-url>
cd MCP_Food_Search

2. 安裝依賴：

pip install -r requirements.txt

或者以開發模式安裝：

pip install -e .

💻 使用示例

基礎用法

GroceryPrices.search

搜索帶有價格和營養信息的雜貨商品。

參數：

• query（必需）：要搜索的食品或產品名稱。
• store（可選）：要搜索的商店，默認為 "trader_joes"。

示例：

{
  "query": "protein bar",
  "store": "trader_joes"
}

響應：返回格式化的產品列表，包含：

• 產品名稱和品牌。
• 價格和包裝規格。
• 蛋白質含量和卡路里。
• 每美元蛋白質比率。
• 營養信息狀態。

🔧 技術細節

架構

服務器由幾個關鍵組件組成：

• MCP服務器 (server.py)：主要的MCP協議實現。
• 數據模型 (models.py)：用於請求/響應的Pydantic模型。
• 爬蟲 (scraper.py)：不同商店的網頁抓取邏輯。
• 營養估算：基於產品名稱的基本營養信息估算。

當前實現

此初始版本包括：

• ✅ 基本的MCP服務器設置。
• ✅ Trader Joe's產品搜索（目前為模擬數據）。
• ✅ 基於產品名稱的營養估算。
• ✅ 每美元蛋白質計算。
• ✅ 錯誤處理和日誌記錄。

未來改進

• 實現真實的網頁抓取。
• 集成美國農業部食品數據中心API。
• 對價格數據進行Redis緩存。
• 支持更多商店（如Safeway、Kroger等）。
• 即時庫存檢查。
• 高級營養分析。

🤝 貢獻說明

這是一個學習項目，歡迎提交問題和改進請求。

📄 許可證

本項目採用MIT許可證。