Food Tracker MCP

🚀 食物追蹤器 MCP

食物追蹤器 MCP 是一個模型上下文協議（MCP）服務器，可用於跟蹤食物消耗、分析營養成分以及管理飲食限制，為用戶提供全面的飲食管理解決方案。

🚀 快速開始

食物追蹤器 MCP 通過整合 OpenFoodFacts 數據庫，提供了一套完整的食物追蹤系統。它允許用戶使用條形碼或關鍵詞搜索食品產品、分析營養信息、創建膳食計劃、記錄飲食攝入、管理飲食限制等。

✨ 主要特性

• 使用條形碼或關鍵詞搜索食品產品
• 分析食品產品的營養信息
• 根據特定營養目標和飲食限制創建膳食計劃
• 記錄飲食攝入情況
• 管理飲食限制和過敏反應
• 檢查產品是否符合用戶的限制要求
• 查看食物記錄和營養總結

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• pip（Python 包管理器）

設置

1. 克隆倉庫或下載 food_tracker.py 文件：

# 方案 1：克隆倉庫（如果有可用倉庫的話）
git clone https://github.com/yourusername/food-tracker-mcp.git
cd food-tracker-mcp

# 方案 2：創建新目錄並保存文件其中
mkdir food-tracker-mcp
cd food-tracker-mcp
# 將 food_tracker.py 文件複製到此目錄中

2. 創建虛擬環境（推薦）：

python -m venv venv

3. 啟動虛擬環境並將包安裝到位：

source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
pip install -r requirements.txt

💻 使用示例

運行服務器

1. 確保已安裝所有依賴項後，運行以下命令啟動 MCP 服務器：

python food_tracker.py

2. 訪問 http://localhost:5000 查看文檔。

與 Claude 集成

1. 在 food_tracker.py 中添加以下代碼以集成 Claude：

from claude_sdk import Claude

# 初始化 Claude 客戶端
claude = Claude()

# 在需要的地方調用 Claude API
response = claude.chat("分析用戶的飲食數據")

提供的工具

基礎用法

1. 獲取產品信息

使用 get_product_by_barcode 函數通過條形碼獲取食品產品的詳細信息：

from food_tracker import get_product_by_barcode

product_info = get_product_by_barcode(barcode="3270190119357")
print(product_info)

2. 記錄飲食攝入

使用 log_food_consumption 函數記錄用戶的飲食攝入情況：

from food_tracker import log_food_consumption

log_food_consumption(
    user_id="user123",
    barcode="3270190119357",
    quantity=1,
    meal_type="breakfast"
)

3. 檢查產品兼容性

使用 check_product_compatibility 函數檢查食品產品是否符合用戶的飲食限制：

from food_tracker import check_product_compatibility

compatibility = check_product_compatibility(
    user_id="user123",
    barcode="3270190119357"
)
print(compatibility)

4. 分析營養信息

使用 analyze_nutrition 函數獲取食品產品的詳細營養分析：

from food_tracker import analyze_nutrition

nutrition_info = analyze_nutrition(barcode="3270190119357")
print(nutrition_info)

5. 查看飲食記錄

使用 view_food_log 函數查看用戶的飲食記錄和營養總結：

from food_tracker import view_food_log

log_summary = view_food_log(user_id="user123")
print(log_summary)

🔧 技術細節

數據存儲

食物追蹤器 MCP 將數據本地存儲在 JSON 文件中：

• 用戶配置文件：./data/users/{user_id}.json
• 飲食記錄：./data/logs/{user_id}_{date}.json

擴展 MCP

你可以通過以下方式擴展 MCP：

1. 添加更多營養分析功能
2. 實現更詳細的飲食計劃和目標
3. 增加基於可用食材的食譜建議
4. 創建報告和可視化工具展示營養數據
5. 實現社交功能以共享進度