Langgraph MCP Nutrition Analyzer

🚀 食品卡路里與蛋白質分析器

這是一款由人工智能驅動的營養助手，它能分析食品圖片，識別其中的食物，計算卡路里和蛋白質含量，並解答與營養相關的問題。該項目基於 LangGraph、Google Gemini、Nutritionix API、Wikipedia 和 Streamlit 構建。

✨ 主要特性

• 食物識別：上傳一張圖片，Gemini 能夠識別出圖片中可見的食物。
• 卡路里與蛋白質計算：Nutritionix API 可提供準確的營養信息。
• 交互式問答：可以針對分析結果提出後續問題（例如：“米飯中含有多少蛋白質？”）。
• 維基百科集成：通過維基百科瞭解食物的營養益處。
• 對話記憶：使用 MemorySaver 跟蹤分析過程和後續問題。
• Streamlit 用戶界面：簡單易用的交互界面。
• MCP 服務器（Render）：通過部署在 Render 上的 FastAPI MCP 服務器提供營養工具服務。

🛠 技術棧

• LangGraph：工作流編排與記憶管理
• Google Gemini：結合視覺和大語言模型進行食物識別與推理
• Nutritionix API：提供營養信息（卡路里、蛋白質等）
• Wikipedia API：提供額外的營養知識
• Streamlit：用於交互的前端框架
• FastAPI + MCP：後端工具服務（部署在 Render 上）

📂 項目結構

.devcontainer/
├── devcontainer.json       # 主配置文件
├── backend/                # 後端 API 與服務
│   ├── requirements.txt    # 後端依賴
│   ├── server.py           # API 服務器
│
├── frontend/               # 基於 Streamlit 的前端
│   ├── app.py              # 主應用程序
│   ├── client.py           # 連接後端
│   ├── requirements.txt    # 前端依賴
│
├── .env.example            # 示例環境文件
├── .gitignore              # Git 忽略規則
├── .python-version         # Python 版本
├── pyproject.toml          # 項目元數據
├── README.md               # 項目文檔
├── requirements.txt        # 根依賴
└── uv.lock                 # 鎖定文件（使用 uv 進行可重複構建）

⚡ 安裝指南

1️⃣ 克隆倉庫

git clone https://github.com/sunilpowar5/LangGraph-MCP-Nutrition-Analyzer.git
cd LangGraph-MCP-Nutrition-Analyzer

2️⃣ 創建虛擬環境並安裝依賴

python -m venv .venv
# 激活虛擬環境
.venv\Scripts\activate      # Windows
source .venv/bin/activate   # Mac/Linux

pip install -r requirements.txt

3️⃣ 添加環境變量 在根目錄下創建一個 .env 文件：

GEMINI_API_KEY=your_google_gemini_api_key
NUTRITIONIX_APP_ID=your_nutritionix_app_id
NUTRITIONIX_API_KEY=your_nutritionix_api_key
LANGCHAIN_API_KEY=your_langchain_api_key

（可以使用 .env.example 作為模板）

4️⃣ 運行應用（Streamlit 前端）

streamlit run frontend/app.py

5️⃣ （可選）運行後端 MCP 服務器

uvicorn backend.server:app --host 0.0.0.0 --port 8000

💻 使用示例

基礎用法

上傳一張食品圖片（jpeg/jpg/png 格式）。系統會識別圖片中的食物，然後 Nutritionix 會獲取這些食物的卡路里和蛋白質信息。你可以提出後續問題，例如：

• “這頓飯健康嗎？”
• “這頓飯有什麼好處？” 你可以隨時開始新的會話。

示例工作流程

上傳圖片 → 檢測到 🍌 + 🥛 Nutritionix 獲取信息 →

香蕉：105 卡路里，1.3 克蛋白質
牛奶：103 卡路里，8 克蛋白質
總計：208 卡路里，9.3 克蛋白質

提問：“牛奶有什麼好處？” → 從維基百科獲取答案。

🚀 路線圖

• 支持多食物圖像分割（邊界框）。
• 添加更多營養 API 以擴大覆蓋範圍。
• 部署到 Streamlit Cloud / AWS。
• 支持多用戶歷史記錄和持久存儲。

🤝 貢獻

歡迎貢獻代碼、提出問題和功能請求！你可以隨時提交 PR 或報告 bug。