Food Tracker 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. 進捗状況を共有するためのソーシャル機能を実装する