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 集成

在 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：

1. 添加更多营养分析功能。
2. 实现更详细的饮食计划和目标。
3. 增加基于可用食材的食谱建议。
4. 创建报告和可视化工具展示营养数据。
5. 实现社交功能以共享进度。