FatSecret MCP Server

[!IMPORTANT] Este no es un servidor MCP oficial de FatSecret. Utiliza la API de la plataforma FatSecret que requiere una cuenta de desarrollador gratuita.

Un servidor MCP (Model Context Protocol) que conecta Claude/Cursor con la API de la plataforma FatSecret. Busca alimentos, controla tu dieta, gestiona recetas y monitorea el peso directamente desde tu asistente de IA.

Disponible en NPM: npx fatsecret-mcp | Extensión de Claude Desktop: fatsecret-mcp.mcpb

✨ Características

• 🔐 Autenticación — Configuración interactiva de credenciales y autorización OAuth

• 🔍 Búsqueda de alimentos — Busca en la extensa base de datos de alimentos de FatSecret con datos nutricionales detallados

• 📷 Búsqueda por código de barras — Encuentra alimentos por código de barras GTIN-13

• 🍳 Búsqueda de recetas — Navega y filtra recetas por calorías, macros y tiempo de preparación

• 📝 Diario de alimentos — Añadir, editar, copiar y eliminar entradas del diario de alimentos

• 🍽️ Comidas guardadas — Crear y gestionar plantillas de comidas reutilizables

• ⚖️ Seguimiento de peso — Registrar y ver el historial de peso

• 🏃♂️ Seguimiento de ejercicio — Ver ejercicios y gestionar entradas de actividad

• ⭐ Favoritos — Gestionar alimentos y recetas favoritos

Related MCP server: fatsecret-mcp-server

🚀 Inicio Rápido

Añade a la configuración de tu cliente MCP:

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

¡Eso es todo! En el primer uso, la IA te guiará a través de la configuración:

1. check_auth_status — detecta credenciales faltantes y te indica qué hacer

2. setup_credentials — proporcionas tus claves API (guardadas en ~/.fatsecret-mcp/config.json)

3. start_auth → complete_auth — autoriza tu cuenta de FatSecret para herramientas de diario/peso

Alternativamente, puedes pasar las credenciales como variables de entorno:

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

🔑 Dónde Obtener Credenciales

1. Crea una cuenta gratuita en platform.fatsecret.com

2. Navega a Mi Cuenta → Claves API

3. Verás tres valores:

   • ID de Cliente (usado tanto para OAuth 2.0 como OAuth 1.0)

   • Secreto de Cliente (OAuth 2.0 - para búsqueda pública de alimentos/recetas)

   • Secreto de Consumidor (OAuth 1.0 - para acceso al perfil/diario del usuario)

📖 Guía paso a paso: Cómo empezar con la API de FatSecret

Claude Desktop (Extensión)

Descarga y abre fatsecret-mcp.mcpb con Claude Desktop. Se te pedirá que ingreses tus credenciales de FatSecret; los secretos se almacenan de forma segura en el llavero del sistema operativo.

Consulta Cómo crear extensiones de escritorio con MCPB para más detalles.

Claude Desktop (Manual)

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

Claude Code (CLI)

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

O con variables de entorno:

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

Verifica con claude mcp list.

Cursor

• Interfaz de configuración — Settings → MCP → + Add new MCP server, luego completa el comando, argumentos y entorno

• Configuración del proyecto — añade JSON a .cursor/mcp.json en la raíz de tu proyecto

• Configuración global — añade JSON a ~/.cursor/mcp.json

🛠️ Herramientas Disponibles

Referencia de la API: Colección FatSecret Postman

🧪 Probar Conexión

npx fatsecret-mcp

O con variables de entorno:

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

📋 Requisitos

• Node.js 18+

• Cuenta de la API de la plataforma FatSecret (platform.fatsecret.com)

• Cliente compatible con MCP (Claude Desktop, Cursor, etc.)

🔧 Desarrollo

1. Clona el repositorio

2. npm install

3. Copia .env.example a .env y completa tus credenciales

4. npm run dev para ejecutar en modo desarrollo

Depuración con MCP Inspector:

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

📄 Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.