mealie-mcp-server

Сервер Model Context Protocol (MCP) для управления рецептами Mealie. Предоставляет 53 инструмента и 1 подсказку для ИИ-ассистентов, позволяющих искать, создавать и управлять рецептами, планами питания, списками покупок, категориями, тегами и продуктами.

Возможности

• Управление рецептами — Поиск, создание, изменение, дублирование и удаление рецептов. Пакетное получение нескольких рецептов с ограниченным параллелизмом.

• Поиск рецептов по ингредиентам — find_recipes_for_ingredients сопоставляет читаемые названия ингредиентов (никогда не UUID продуктов Mealie) с таксономией продуктов Mealie и находит подходящие рецепты через Recipe Finder Mealie, возвращаясь к обычному поиску рецептов, если нет точного совпадения — полезно для поиска в стиле «что можно приготовить из X», включая ингредиенты, которые Mealie не знает под таким точным названием (вызывающая LLM расширяет поиск альтернативными терминами; сам MCP никогда не предполагает замены). См. Поиск рецептов по ингредиенту в разделе Workflows.

• Назначение категорий и тегов рецептам — Назначение категорий и тегов существующим рецептам с семантикой слияния/замены, разрешением по имени/слагу/ID и опциональным автоматическим созданием отсутствующих значений, не затрагивая ингредиенты, инструкции, питательную ценность или любое другое поле рецепта. Доступно через patch_recipe, update_recipe_taxonomy и update_recipe_taxonomy_batch. См. Назначение категорий и тегов в разделе Workflows.

• Планирование питания — Просмотр, создание и массовое создание планов питания. Составной инструмент получает планы питания с встроенными деталями рецептов (включая питательную ценность) с использованием параллельных пакетных запросов, устраняя N+1 запросы.

• Списки покупок — Полный CRUD для списков и элементов, массовые операции и интеграция рецептов в списки.

• Категории и теги — Полный CRUD для организации рецептов, включая обнаружение пустых категорий/тегов.

• Продукты — Полный CRUD для таксономии продуктов (многоразовые структурированные сущности ингредиентов), включая управление псевдонимами и назначение меток продуктов. См. Разрешение или создание продукта в разделе Workflows.

• Структурированная запись ингредиентов — update_recipe_ingredients заменяет полный набор структурированных ингредиентов рецепта, используя уже разрешенные ссылки на продукты/единицы, не затрагивая другие поля рецепта. См. Обновление структурированных ингредиентов рецепта в разделе Workflows.

• Пакетные и составные инструменты — get_recipes_batch и get_recipes_detailed_batch для поиска рецептов с ограниченным параллелизмом, get_mealplan_with_recipes для планов питания с встроенными данными рецептов и фильтрацией по дате на стороне клиента, update_recipe_taxonomy_batch для обновления категорий/тегов с ограниченным параллелизмом для многих рецептов.

• Лента классификации рецептов — get_recipes_for_classification — это компактная, постраничная, доступная только для чтения лента, специально созданная для назначения категорий/тегов с помощью ИИ. Она позволяет избежать тайм-аутов, которые могут возникать у пакетных/детальных инструментов на больших наборах рецептов, фильтруя с помощью дешевой конечной точки списка, получая полные детали только для совпадений с тем же ограниченным параллелизмом, что и выше, и разбивая на страницы с помощью стабильного курсора, который переживает параллельные изменения таксономии. См. Рабочий процесс классификации рецептов в разделе Workflows.

• Ноль зависимостей времени выполнения, кроме SDK — Использует нативный fetch, без axios или httpx.

Related MCP server: mcp-mealie

Требования

• Node.js >= 22

• Запущенный экземпляр Mealie с API-ключом

Установка

Быстрый старт (npx)

MEALIE_BASE_URL=https://your-mealie-instance.com \
MEALIE_API_KEY=your-api-key \
npx mealie-mcp-server

Конфигурация opencode

Добавьте в ваш opencode.json:

{
  "mcp": {
    "mealie-mcp-server": {
      "type": "local",
      "command": ["npx", "mealie-mcp-server"],
      "enabled": true,
      "environment": {
        "MEALIE_BASE_URL": "https://your-mealie-instance.com",
        "MEALIE_API_KEY": "your-api-key"
      }
    }
  }
}

Docker

Запустите MCP-сервер в контейнере:

docker run -d \
  --name mealie-mcp-server \
  -e MEALIE_BASE_URL=https://your-mealie-instance.com \
  -e MEALIE_API_KEY=your-api-key \
  ghcr.io/timo-reymann/mealie-mcp-server:main

Или с помощью Docker Compose:

version: '3.8'
services:
  mealie-mcp-server:
    image: ghcr.io/timo-reymann/mealie-mcp-server:main
    environment:
      MEALIE_BASE_URL: https://your-mealie-instance.com
      MEALIE_API_KEY: your-api-key
    restart: unless-stopped

Локальная разработка

git clone https://github.com/timo-reymann/mealie-mcp-server.git
cd mealie-mcp-server
corepack enable
yarn install
cp .env.template .env
# Edit .env with your MEALIE_BASE_URL and MEALIE_API_KEY
yarn dev

Убедитесь, что MEALIE_BASE_URL и MEALIE_API_KEY установлены в вашем окружении или в конфигурации opencode.

Документация

• API Coverage — каждый инструмент сопоставлен с соответствующими конечными точками API Mealie.

• Workflows — руководства по использованию и примеры полезных нагрузок для более сложных инструментов: поиск ингредиентов, назначение таксономии, продукты, структурированная запись ингредиентов и лента классификации рецептов.

• Architecture — внутренние заметки по дизайну для контрибьюторов: обоснование ограниченного параллелизма, дизайн пагинации/курсора и известные особенности API Mealie.

Контрибьюторы

Мне очень важна ваша помощь! Пожалуйста, прочитайте Руководство по внесению вклада, чтобы начать.

Хотите появиться в списке контрибьюторов?

Начните с чтения Руководства по внесению вклада

Разработка

Требования

• Node.js >= 22

• Yarn (через Corepack: corepack enable)

• Экземпляр Mealie для интеграционного тестирования (или имитация слоя fetch)

Тест

yarn test

Проверка типов

yarn typecheck

Сборка

yarn build

Линтинг

yarn lint

Доступные инструменты (всего 53)

Рецепты (16)

get_recipes, find_recipes_for_ingredients, get_recipe_detailed, get_recipe_concise, get_recipes_batch, get_recipes_detailed_batch, get_recipes_for_classification, create_recipe, patch_recipe, update_recipe_ingredients, update_recipe_taxonomy, update_recipe_taxonomy_batch, duplicate_recipe, mark_recipe_last_made, set_recipe_image_from_url, delete_recipe

Планы питания (5)

get_all_mealplans, get_mealplan_with_recipes, create_mealplan, create_mealplan_bulk, get_todays_mealplan

Категории (7)

get_categories, get_empty_categories, create_category, get_category, get_category_by_slug, update_category, delete_category

Теги (7)

get_tags, get_empty_tags, create_tag, get_tag, get_tag_by_slug, update_tag, delete_tag

Списки покупок (13)

get_shopping_lists, create_shopping_list, get_shopping_list, update_shopping_list, delete_shopping_list, add_recipe_to_shopping_list, remove_recipe_from_shopping_list, get_shopping_list_items, create_shopping_list_item, create_shopping_list_items_bulk, update_shopping_list_item, delete_shopping_list_item, delete_shopping_list_items_bulk

Продукты (5)

get_foods, get_food, create_food, update_food, delete_food

Лицензия

MIT