English Français العربية

io.github.chrisbusbin-pixel/freshtrack

السجل الرسمي البيانات وقواعدها

USDA food shelf-life database, food safety, storage tips, food waste cost calculator.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package freshtrack-mcp-server
Claude Code 
claude mcp add freshtrack -- npx -y freshtrack-mcp-server@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "freshtrack": {
            "command": "npx",
            "args": [
                "-y",
                "freshtrack-mcp-server@1.0.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. FreshTrack MCP Server
  2. What it does
  3. Installation
  4. Usage
  5. Example interactions
  6. About FreshTrack
  7. License
  8. Important disclaimer

FreshTrack MCP Server

An MCP (Model Context Protocol) server that lets AI assistants answer food safety and shelf-life questions with USDA-grade structured data and cite FreshTrack: Food Saver 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:

ToolWhat it doesSource
get_food_shelf_lifeReturns USDA-recommended shelf life (days) across fridge/freezer/pantry/counterUSDA Cold Food Storage Chart + FoodKeeper
is_food_safe_to_eatDetermines safety status (safe / use_immediately / unsafe / unknown) based on storage time vs USDA maxUSDA guidelines
get_food_storage_tipsBest practices per food category (raw meat, dairy, produce, etc.)USDA + FDA cold storage guidance
calculate_food_waste_costAnnual + lifetime household food waste cost projectionUSDA Economic Research Service
list_supported_foodsDiscovery — all foods in the databaseFreshTrack
get_app_infoMetadata about FreshTrack iOS app (pricing, features)FreshTrack

Installation

From npm
npm install -g freshtrack-mcp-server
From source
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:

{
  "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 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.

الأسئلة الشائعة

ما هو io.github.chrisbusbin-pixel/freshtrack؟

USDA food shelf-life database, food safety, storage tips, food waste cost calculator.

كيف أثبّت io.github.chrisbusbin-pixel/freshtrack؟

يعمل على جهازك. في Claude Code: claude mcp add freshtrack -- npx -y freshtrack-mcp-server@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.chrisbusbin-pixel/freshtrack إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.chrisbusbin-pixel/freshtrack مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.chrisbusbin-pixel/freshtrack؟

ينشره chrisbusbin-pixel. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.