FatSecret MCP Server

[!ВАЖНО] Это не официальный MCP-сервер от FatSecret. Он использует FatSecret Platform API, для которого требуется бесплатный аккаунт разработчика.

MCP-сервер (Model Context Protocol), который подключает Claude/Cursor к FatSecret Platform API. Ищите продукты, отслеживайте рацион, управляйте рецептами и контролируйте вес прямо из вашего AI-ассистента.

Доступен на NPM: npx fatsecret-mcp | Расширение для Claude Desktop: fatsecret-mcp.mcpb

✨ Возможности

• 🔐 Аутентификация — Интерактивная настройка учетных данных и OAuth-авторизация

• 🔍 Поиск продуктов — Поиск по обширной базе продуктов FatSecret с детальными данными о питательной ценности

• 📷 Поиск по штрихкоду — Поиск продуктов по GTIN-13 штрихкоду

• 🍳 Поиск рецептов — Просмотр и фильтрация рецептов по калориям, макронутриентам и времени приготовления

• 📝 Дневник питания — Добавление, редактирование, копирование и удаление записей в дневнике питания

• 🍽️ Сохраненные приемы пищи — Создание и управление многоразовыми шаблонами приемов пищи

• ⚖️ Отслеживание веса — Запись и просмотр истории веса

• 🏃♂️ Отслеживание упражнений — Просмотр упражнений и управление записями активности

• ⭐ Избранное — Управление избранными продуктами и рецептами

Related MCP server: fatsecret-mcp-server

🚀 Быстрый старт

Добавьте в конфигурацию вашего MCP-клиента:

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

Вот и всё! При первом использовании AI проведет вас через настройку:

1. check_auth_status — определяет отсутствие учетных данных и сообщает, что делать

2. setup_credentials — вы предоставляете свои API-ключи (сохраняются в ~/.fatsecret-mcp/config.json)

3. start_auth → complete_auth — авторизуйте свой аккаунт FatSecret для использования инструментов дневника/веса

Также можно передать учетные данные через переменные окружения:

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

🔑 Где взять учетные данные

1. Создайте бесплатный аккаунт на platform.fatsecret.com

2. Перейдите в Мой аккаунт → API-ключи

3. Вы увидите три значения:

   • Client ID (используется как для OAuth 2.0, так и для OAuth 1.0)

   • Client Secret (OAuth 2.0 — для публичного поиска продуктов/рецептов)

   • Consumer Secret (OAuth 1.0 — для доступа к профилю пользователя/дневнику)

📖 Пошаговое руководство: Начало работы с FatSecret API

Claude Desktop (Расширение)

Скачайте и откройте fatsecret-mcp.mcpb с помощью Claude Desktop. Вам будет предложено ввести учетные данные FatSecret — секреты надежно хранятся в связке ключей ОС.

Подробнее см. Создание расширений для Desktop с помощью MCPB.

Claude Desktop (Вручную)

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

Claude Code (CLI)

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

Или с переменными окружения:

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

Проверьте с помощью claude mcp list.

Cursor

• Интерфейс настроек — Settings → MCP → + Add new MCP server, затем заполните команду, аргументы и окружение

• Конфигурация проекта — добавьте JSON в .cursor/mcp.json в корне проекта

• Глобальная конфигурация — добавьте JSON в ~/.cursor/mcp.json

🛠️ Доступные инструменты

Справочник API: Коллекция FatSecret Postman

🧪 Проверка подключения

npx fatsecret-mcp

Или с переменными окружения:

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

📋 Требования

• Node.js 18+

• Аккаунт FatSecret Platform API (platform.fatsecret.com)

• MCP-совместимый клиент (Claude Desktop, Cursor и др.)

🔧 Разработка

1. Клонируйте репозиторий

2. npm install

3. Скопируйте .env.example в .env и заполните свои учетные данные

4. npm run dev для запуска в режиме разработки

Отладка с помощью MCP Inspector:

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

📄 Лицензия

Лицензия MIT — подробности см. в файле LICENSE.