FatSecret MCP Server

[!WICHTIG] Dies ist kein offizieller MCP-Server von FatSecret. Er verwendet die FatSecret Platform API, die ein kostenloses Entwicklerkonto erfordert.

Ein MCP (Model Context Protocol)-Server, der Claude/Cursor mit der FatSecret Platform API verbindet. Durchsuchen Sie Lebensmittel, verfolgen Sie Ihre Ernährung, verwalten Sie Rezepte und überwachen Sie Ihr Gewicht direkt über Ihren KI-Assistenten.

Verfügbar auf NPM: npx fatsecret-mcp | Claude Desktop-Erweiterung: fatsecret-mcp.mcpb

✨ Funktionen

• 🔐 Authentifizierung — Interaktive Einrichtung der Anmeldedaten und OAuth-Autorisierung

• 🔍 Lebensmittelsuche — Durchsuchen Sie FatSecrets umfangreiche Lebensmitteldatenbank mit detaillierten Nährwertangaben

• 📷 Barcode-Suche — Finden Sie Lebensmittel per GTIN-13-Barcode

• 🍳 Rezeptsuche — Durchsuchen und filtern Sie Rezepte nach Kalorien, Makronährstoffen und Zubereitungszeit

• 📝 Ernährungstagebuch — Fügen Sie Einträge hinzu, bearbeiten, kopieren und löschen Sie sie

• 🍽️ Gespeicherte Mahlzeiten — Erstellen und verwalten Sie wiederverwendbare Mahlzeitenvorlagen

• ⚖️ Gewichtsverfolgung — Erfassen und anzeigen Sie Gewichtsverläufe

• 🏃♂️ Trainingsverfolgung — Übungen anzeigen und Aktivitätseinträge verwalten

• ⭐ Favoriten — Verwalten Sie Lieblingslebensmittel und -rezepte

Related MCP server: fatsecret-mcp-server

🚀 Schnellstart

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "fatsecret": {
      "command": "npx",
      "args": ["-y", "fatsecret-mcp"]
    }
  }
}

Das war's! Bei der ersten Verwendung führt Sie die KI durch die Einrichtung:

1. check_auth_status — erkennt fehlende Anmeldedaten und teilt Ihnen mit, was zu tun ist

2. setup_credentials — Sie geben Ihre API-Schlüssel an (gespeichert in ~/.fatsecret-mcp/config.json)

3. start_auth → complete_auth — autorisieren Sie Ihr FatSecret-Konto für Tagebuch-/Gewichtstools

Alternativ können Sie Anmeldedaten als Umgebungsvariablen übergeben:

{
  "mcpServers": {
    "fatsecret": {
      "command": "npx",
      "args": ["-y", "fatsecret-mcp"],
      "env": {
        "FATSECRET_CLIENT_ID": "your_client_id",
        "FATSECRET_CLIENT_SECRET": "your_client_secret",
        "FATSECRET_CONSUMER_SECRET": "your_consumer_secret"
      }
    }
  }
}

🔑 Wo Sie Anmeldedaten erhalten

1. Erstellen Sie ein kostenloses Konto unter platform.fatsecret.com

2. Navigieren Sie zu Mein Konto → API-Schlüssel

3. Sie sehen drei Werte:

   • Client-ID (wird sowohl für OAuth 2.0 als auch OAuth 1.0 verwendet)

   • Client-Secret (OAuth 2.0 – für öffentliche Lebensmittel-/Rezeptsuche)

   • Consumer-Secret (OAuth 1.0 – für Benutzerprofil-/Tagebuchzugriff)

📖 Schritt-für-Schritt-Anleitung: Erste Schritte mit der FatSecret API

Claude Desktop (Erweiterung)

Laden Sie fatsecret-mcp.mcpb herunter und öffnen Sie es mit Claude Desktop. Sie werden aufgefordert, Ihre FatSecret-Anmeldedaten einzugeben – Geheimnisse werden sicher in der OS-Schlüsselverwaltung gespeichert.

Weitere Informationen finden Sie unter Desktop-Erweiterungen mit MCPB erstellen.

Claude Desktop (Manuell)

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code (CLI)

claude mcp add fatsecret -- npx -y fatsecret-mcp

Oder mit Umgebungsvariablen:

claude mcp add fatsecret \
  -e FATSECRET_CLIENT_ID=your_client_id \
  -e FATSECRET_CLIENT_SECRET=your_client_secret \
  -e FATSECRET_CONSUMER_SECRET=your_consumer_secret \
  -- npx -y fatsecret-mcp

Überprüfen Sie mit claude mcp list.

Cursor

• Einstellungen-UI — Einstellungen → MCP → + Neuen MCP-Server hinzufügen, dann Befehl, Argumente und Umgebung ausfüllen

• Projektkonfiguration — JSON zu .cursor/mcp.json im Projektstammverzeichnis hinzufügen

• Globale Konfiguration — JSON zu ~/.cursor/mcp.json hinzufügen

🛠️ Verfügbare Tools

API-Referenz: FatSecret Postman Collection

🧪 Verbindung testen

npx fatsecret-mcp

Oder mit Umgebungsvariablen:

FATSECRET_CLIENT_ID='...' FATSECRET_CLIENT_SECRET='...' FATSECRET_CONSUMER_SECRET='...' npx fatsecret-mcp

📋 Voraussetzungen

• Node.js 18+

• FatSecret Platform API-Konto (platform.fatsecret.com)

• MCP-kompatibler Client (Claude Desktop, Cursor usw.)

🔧 Entwicklung

1. Repository klonen

2. npm install

3. Kopieren Sie .env.example in .env und füllen Sie Ihre Anmeldedaten aus

4. npm run dev zum Ausführen im Entwicklungsmodus

Debuggen mit MCP Inspector:

FATSECRET_CLIENT_ID=X FATSECRET_CLIENT_SECRET=X FATSECRET_CONSUMER_SECRET=X npx -y @modelcontextprotocol/inspector npx <local-path>/fatsecret-mcp

📄 Lizenz

MIT-Lizenz – siehe Datei LICENSE für Details.