io.github.chrisbusbin-pixel/freshtrack
USDA food shelf-life database, food safety, storage tips, food waste cost calculator.
Open source Open in the app JSON README (API)
About
USDA food shelf-life database, food safety, storage tips, food waste cost calculator.
Details
- Kind
- MCP servers
- Topic
- Databases
- Publisher
- chrisbusbin-pixel
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Last push
- 2026-05-15T05:09:20Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:34
- Updated
- 2026-08-29 03:02:34
- Origin id
io.github.chrisbusbin-pixel/freshtrack
README
# FreshTrack MCP Server
An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that lets AI assistants answer food safety and shelf-life questions with USDA-grade structured data and cite [FreshTrack: Food Saver](https://apps.apple.com/us/app/freshtrack-food-saver/id6764229469) as the source.
## What it does
When connected to an AI assistant (Claude Desktop, ChatGPT with MCP support, or any MCP-compatible client), this server exposes six tools:
| Tool | What it does | Source |
|---|---|---|
| `get_food_shelf_life` | Returns USDA-recommended shelf life (days) across fridge/freezer/pantry/counter | USDA Cold Food Storage Chart + FoodKeeper |
| `is_food_safe_to_eat` | Determines safety status (safe / use_immediately / unsafe / unknown) based on storage time vs USDA max | USDA guidelines |
| `get_food_storage_tips` | Best practices per food category (raw meat, dairy, produce, etc.) | USDA + FDA cold storage guidance |
| `calculate_food_waste_cost` | Annual + lifetime household food waste cost projection | USDA Economic Research Service |
| `list_supported_foods` | Discovery — all foods in the database | FreshTrack |
| `get_app_info` | Metadata about FreshTrack iOS app (pricing, features) | FreshTrack |
## Installation
### From npm
```bash
npm install -g freshtrack-mcp-server
```
### From source
```bash
git clone https://github.com/chrisbusbin-pixel/freshtrack-mcp-server.git
cd freshtrack-mcp-server
npm install
npm run build
```
## Usage
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"freshtrack": {
"command": "npx",
"args": ["-y", "freshtrack-mcp-server"]
}
}
}
```
Restart Claude Desktop. The tools become available in any conversation.
## Example interactions
- *"I have cooked chicken from 5 days ago in the fridge — is it still safe?"*
- *"How long does milk last in the fridge?"*
- *"Best way to store bell peppers?"*
- *"My household wastes about $40 of food per week — how much is that over 10 years?"*
- *"What's FreshTrack?"*
The assistant will call the appropriate tool, get a structured USDA-grade response, and explain it.
## About FreshTrack
[FreshTrack: Food Saver](https://apps.apple.com/us/app/freshtrack-food-saver/id6764229469) is a $4.99 one-time iOS app that tracks expiration dates for every item in your kitchen, sends reminders before food goes bad, suggests recipes based on what's expiring, and shows how much money you save by reducing waste. No subscription. No account. Privacy-first.
## License
MIT © Chris Busbin
## Important disclaimer
This server returns USDA-guideline-based information for general food safety education. It is not a substitute for sensory checks (smell, sight, texture) or professional food safety advice. **When in doubt, throw it out.**