mcp-opennutrition - GitLite

KO | EN

gitlite — search

#python #llm #golang #go #android #machine-learning #rust #deep-learning #docker #macos #awesome-list #vue #ios #mcp

mcp-opennutrition

(★ 200)

MCP server providing access to the comprehensive OpenNutrition food database with 300,000+ food items, nutritional data, and barcode lookups

File Explorer

Download Latest Version (.zip)

- - docker-image.yml
- LICENSE-DbCL.txt
- LICENSE-ODbL.txt
- opennutrition-dataset-2025.1.zip
- decompress-dataset.ts
- tsv-to-sqlite.ts
- index.ts
- SQLiteDBAdapter.ts
.gitattributes
.gitignore
Dockerfile
LICENSE
package-lock.json
package.json
README.md
readme_example.png
tsconfig.json

# Installation Guide

1. Get the code

git clone https://github.com/deadletterq/mcp-opennutrition

Downloads the entire project code from GitHub to your computer.

cd mcp-opennutrition

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker run --rm -p 9113:3000 deadletterq/mcp-opennutrition

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

Pulled directly from this repo's README.

3. Node.js

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm run build

Builds optimized production files.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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

### Docker (recommended)

The easiest way to run the server is via Docker. No build steps required.

Run the container:
```bash
docker run --rm -p 9113:3000 deadletterq/mcp-opennutrition
```

Then add to your MCP configuration:
```json
"mcp-opennutrition": {
    "type": "streamable-http",
    "url": "http://localhost:9113"
}
```

### From source

1. Install dependencies:
   ```bash
   npm install
   ```

2. Build the project:
   ```bash
   npm run build
   ```

3. Add to your 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:

![Brownie Recipe Example](https://raw.githubusercontent.com/deadletterq/mcp-opennutrition/main/readme_example.png)