# nutrition-mcp-server

MCP Server for nutrition data powered by **USDA FoodData Central** — the official U.S. government food database with 1,000,000+ foods.

[![PyPI](https://img.shields.io/pypi/v/nutrition-mcp-server)](https://pypi.org/project/nutrition-mcp-server/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## Features

- **Search 1M+ foods** in the USDA database (branded, foundation, and SR Legacy data)
- **Detailed nutrition facts** — calories, protein, fat, carbs, vitamins, minerals
- **Compare two foods** side-by-side across key nutrients
- **Find foods high in** any nutrient (iron, protein, fiber, vitamin C, etc.)
- **Daily Value calculator** — see what % of daily intake a meal covers
- **Nutrient education** — functions, deficiency signs, top food sources
- No API key required — uses USDA DEMO_KEY (30 requests/hour)

## Tools

| Tool | Description |
|------|-------------|
| `tool_search_food` | Search USDA database by name |
| `tool_get_nutrition_facts` | Full nutrition panel for any food (by FDC ID) |
| `tool_compare_foods` | Side-by-side comparison of two foods |
| `tool_find_foods_high_in` | Find top foods for a specific nutrient |
| `tool_get_daily_values` | FDA Daily Values reference table |
| `tool_calculate_daily_intake` | Calculate % of daily needs covered |
| `tool_get_food_categories` | Browse USDA database categories |
| `tool_get_nutrient_info` | Education on vitamins & minerals |

## Installation

```bash
pip install nutrition-mcp-server
```

## Claude Desktop Config

```json
{
  "mcpServers": {
    "nutrition": {
      "command": "nutrition-mcp-server"
    }
  }
}
```

## Data Source

[USDA FoodData Central](https://fdc.nal.usda.gov/) — maintained by the U.S. Department of Agriculture, National Agricultural Library.

## License

MIT