🚀 食物追踪器 MCP
食物追踪器 MCP 是一个模型上下文协议（MCP）服务器，可用于跟踪食物消耗、分析营养成分以及管理饮食限制，为用户提供全面的饮食管理解决方案。
🚀 快速开始
食物追踪器 MCP 通过整合 OpenFoodFacts 数据库，提供了一套全面的食物追踪系统，具备以下实用功能：
- 支持使用条形码或关键词搜索食品产品。
- 能够分析食品产品的营养信息。
- 可根据特定营养目标和饮食限制创建膳食计划。
- 方便记录饮食摄入情况。
- 有效管理饮食限制和过敏反应。
- 可检查产品是否符合用户的限制要求。
- 支持查看食物记录和营养总结。
📦 安装指南
先决条件
- 需要 Python 3.8 或更高版本。
- 需安装
pip（Python 包管理器）。
设置
- 克隆仓库或下载
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 文件复制到此目录中
- 创建虚拟环境（推荐）：
python -m venv venv
- 启动虚拟环境并将包安装到位：
source venv/bin/activate # 在 Windows 上使用 `venv\Scripts\activate`
pip install -r requirements.txt
💻 使用示例
运行服务器
- 确保已安装所有依赖项后，运行以下命令启动 MCP 服务器：
python food_tracker.py
- 访问 http://localhost:5000 查看文档。
与 Claude 集成
在 food_tracker.py 中添加以下代码以集成 Claude：
from claude_sdk import Claude
# 初始化 Claude 客户端
claude = Claude()
# 在需要的地方调用 Claude API
response = claude.chat("分析用户的饮食数据")
提供的工具
基础用法
- 获取产品信息：使用
get_product_by_barcode函数通过条形码获取食品产品的详细信息：
from food_tracker import get_product_by_barcode
product_info = get_product_by_barcode(barcode="3270190119357")
print(product_info)
- 记录饮食摄入：使用
log_food_consumption函数记录用户的饮食摄入情况：
from food_tracker import log_food_consumption
log_food_consumption(
user_id="user123",
barcode="3270190119357",
quantity=1,
meal_type="breakfast"
)
- 检查产品兼容性：使用
check_product_compatibility函数检查食品产品是否符合用户的饮食限制：
from food_tracker import check_product_compatibility
compatibility = check_product_compatibility(
user_id="user123",
barcode="3270190119357"
)
print(compatibility)
- 分析营养信息：使用
analyze_nutrition函数获取食品产品的详细营养分析：
from food_tracker import analyze_nutrition
nutrition_info = analyze_nutrition(barcode="3270190119357")
print(nutrition_info)
- 查看饮食记录：使用
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：
- 添加更多营养分析功能。
- 实现更详细的饮食计划和目标。
- 增加基于可用食材的食谱建议。
- 创建报告和可视化工具展示营养数据。
- 实现社交功能以共享进度。