膳食营养搜索服务

基于FastAPI的膳食营养数据服务,整合TheMealDB食谱数据和USDA营养数据库,提供餐食搜索、详情查询、分类检索及营养分析功能。

  • by salindersidhu
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 salindersidhu/food-mcp-server

使用说明

食品MCP服务器

概述

一个基于FastAPI的MCP服务器,它公开了用于搜索膳食、获取膳食详细信息、类别、地区菜肴和营养信息的端点。它将TheMealDB的食谱数据与美国农业部食品数据中心数据库的全面营养信息相结合,让您在了解菜肴营养成分的同时探索菜肴。使用Python和其他开源技术构建。

必备软件

软件 版本
Git 2.20.1+
Python 3.11+

入门指南

  1. 克隆存储库:
git clone git@github.com:salindersidhu/food-mcp-server.git
cd food-mcp-server
  1. (推荐)使用紫外线进行环境和依赖性管理:
pip install uv  # Only needed once, if you don't have uv already
uv venv         # Creates a .venv and installs dependencies
uv pip install -e .  # Installs your package in editable mode
  1. 设置环境变量:

    • 在上注册免费的美国农业部食品数据中心API密钥 https://fdc.nal.usda.gov/api-key-signup.html
    • 复制示例环境文件:
      cp .env.example .env
      
    • 编辑 .env 归档并替换 your_api_key_here 使用实际的美国农业部API密钥
  2. (可选)添加到Claude Desktop作为工具:

    • 运行以下命令将此服务器注册为Claude Desktop中的工具:

      uv run mcp install main.py
      

跑步

要在本地启动MCP服务器:

mcp run main.py

生产

  1. 将您的更改合并到主分支中。
  2. 使用您首选的Python托管或容器解决方案进行部署。

项目结构

.
├── main.py              # MCP server entry point
├── pyproject.toml       # Project metadata and dependencies
├── LICENSE              # License file
├── README.md            # This file
└── ...

许可证

此项目根据Apache许可证2.0获得许可。