Metadata-Version: 2.4
Name: nutrition-mcp-server
Version: 0.1.0
Summary: MCP Server for nutrition data — USDA FoodData Central with 1M+ foods, nutrients, vitamins and dietary analysis
Project-URL: Homepage, https://github.com/AiAgentKarl/nutrition-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/nutrition-mcp-server
Author-email: AiAgentKarl <coach1916@gmail.com>
License: MIT
Keywords: calories,diet,food,health,mcp,minerals,nutrition,usda,vitamins
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Description-Content-Type: text/markdown

# 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
