README.md•1.97 kB
# MCP OpenNutrition
A Model Context Protocol (MCP) server providing access to the comprehensive OpenNutrition food database with 300,000+ food items, nutritional data, and barcode lookups.
OpenNutrition addresses the longstanding issues with fragmented and unreliable nutritional data by combining authoritative public sources (USDA, CNF, FRIDA, AUSNUT). Unlike other databases that suffer from inconsistent user-generated content or restrictive commercial licensing, OpenNutrition provides transparent, comprehensive, and accurate nutritional data that's freely accessible to developers and researchers.
## Tools
- **Search by Name**: Find foods by name, brand, or partial matches
- **Browse Foods**: Get paginated lists of all available foods
- **Get by ID**: Retrieve detailed nutritional information using food IDs
- **Barcode Lookup**: Find foods using EAN-13 barcodes
## Installation
1. Install dependencies:
```bash
npm install
```
2. Build the project:
```bash
npm run build
```
3. Add to your Claude/Cline MCP configuration (set the same version of node that you used to build the project):
```json
"mcp-opennutrition": {
"command": "/Users/YOUR.USERNAME/.nvm/versions/node/v20.19.0/bin/node",
"args": [
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-opennutrition/build/index.js"
]
}
```
## Data Source
This server uses the [OpenNutrition dataset](https://www.opennutrition.app/).
The dataset provides comprehensive nutritional profiles including macronutrients, vitamins, and minerals.
## Usage
Once configured, the MCP server runs fully locally on your machine and automatically provides food and nutrition query capabilities to Claude/Cline. All data processing and queries happen locally with no external API calls, ensuring privacy and fast response times.
## Example
Here is an example of how Claude uses the tool for a brownie recipe:
