Skip to main content
Glama

mealie-mcp

Сервер Model Context Protocol, который предоставляет Mealie — self-hosted менеджер рецептов — в виде набора инструментов, вызываемых LLM. Он позволяет Claude Desktop / Claude Code (или любому другому MCP-клиенту) искать рецепты, получать подробную информацию, управлять планом питания и редактировать списки покупок в вашем экземпляре Mealie.

Инструменты

Инструмент

Назначение

search_recipes(query?, tags?, limit?)

Поиск рецептов; возвращает слаг, название, описание, теги, категории

get_recipe(slug)

Полный JSON рецепта по слагу

list_meal_plan(start_date, end_date)

Записи плана питания между двумя датами в формате ISO

list_shopping_lists()

ID и названия всех списков покупок

add_shopping_list_items(list_id, items[])

Добавление текстовых элементов в список

create_recipe(name)

Создание пустого рецепта; возвращает сгенерированный слаг

create_meal_plan_entry(date, entry_type, recipe_slug?, title?)

Добавление записи в план питания

Related MCP server: Mealie MCP Server

Требования

  • Python 3.11+

  • Запущенный экземпляр Mealie (self-hosted; протестировано с Mealie v2)

  • Долгосрочный API-токен Mealie (Профиль пользователя → API Tokens в интерфейсе Mealie)

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

Скопируйте .env.example в .env и заполните значения:

cp .env.example .env

Переменная

Обязательно

По умолчанию

Описание

MEALIE_URL

да

—

Базовый URL вашего экземпляра Mealie (например, http://localhost:9011 или http://mealie:9000)

MEALIE_API_TOKEN

да

—

Долгосрочный токен доступа (bearer token) из Mealie

MCP_TRANSPORT

нет

sse

stdio для локального подпроцесса, sse для HTTP-потока

MCP_HOST

нет

0.0.0.0

Адрес привязки для режима SSE

MCP_PORT

нет

8000

Порт для режима SSE

Установка и локальный запуск

pip install -e .
# stdio mode (for Claude Desktop):
MCP_TRANSPORT=stdio mealie-mcp
# sse/http mode (for docker-compose / remote clients):
MCP_TRANSPORT=sse MCP_PORT=8000 mealie-mcp

SSE-эндпоинт доступен по адресу http://<host>:<port>/sse.

Конфигурация Claude Desktop

Отредактируйте файл конфигурации Claude Desktop (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mealie": {
      "command": "mealie-mcp",
      "env": {
        "MEALIE_URL": "http://localhost:9011",
        "MEALIE_API_TOKEN": "paste-your-token-here",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Если mealie-mcp отсутствует в вашем PATH, укажите полный путь к бинарному файлу в command (например, /Users/you/.venvs/mealie-mcp/bin/mealie-mcp) или запускайте через Python:

{
  "mcpServers": {
    "mealie": {
      "command": "python",
      "args": ["-m", "mealie_mcp"],
      "env": {
        "MEALIE_URL": "http://localhost:9011",
        "MEALIE_API_TOKEN": "paste-your-token-here",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Перезапустите Claude Desktop после редактирования конфигурации.

Docker / docker-compose

Включен Dockerfile. Для запуска в автономном режиме:

docker build -t mealie-mcp .
docker run --rm -p 8765:8000 \
  -e MEALIE_URL=http://host.docker.internal:9011 \
  -e MEALIE_API_TOKEN=your-token \
  mealie-mcp

Чтобы добавить сервер в существующий стек Mealie, см. docker-compose.snippet.yml:

services:
  mealie-mcp:
    build:
      context: ./mealie-mcp
    depends_on:
      - mealie
    environment:
      MEALIE_URL: "http://mealie:9000"
      MEALIE_API_TOKEN: "${MEALIE_API_TOKEN}"
      MCP_TRANSPORT: "sse"
      MCP_HOST: "0.0.0.0"
      MCP_PORT: "8000"
    ports:
      - "8765:8000"

Укажите вашему MCP-клиенту адрес http://<docker-host>:8765/sse.

Ручное тестирование сервера

Когда сервер запущен в режиме SSE, проверьте его доступность:

curl -N http://localhost:8000/sse

Вы должны увидеть открытие потока событий SSE. Для режима stdio Claude Desktop выполняет рукопожатие — HTTP-эндпоинта не существует.

Структура проекта

mealie-mcp/
├── pyproject.toml
├── Dockerfile
├── docker-compose.snippet.yml
├── .env.example
├── README.md
└── src/mealie_mcp/
    ├── __init__.py
    ├── __main__.py        # CLI entry point (loads .env, dispatches transport)
    ├── server.py          # FastMCP server + tool definitions
    └── client.py          # Async httpx wrapper for the Mealie REST API

Лицензия

MIT

Related MCP Connectors

  • Scraps Kitchen gives any AI agent a persistent, household-aware kitchen memory. Unlike generic chatbot recall, Scraps maintains structured cooking data: what's in your fridge (with freshness tracking), who you cook for (with allergens, dietary restrictions, and preferences), your recipe collection (with cook notes and per-diner ratings), your shopping list, and your kitchen equipment. 27 tools across 6 domains let agents read kitchen context, suggest meals that respect dietary safety, update the pantry after cooking, and build a history of what works for your household. Every interaction makes the data richer. Cooking history, preference signals, kitchen awareness = better suggestions next time. All tools work via oAuth and a free scraps.kitchen account.

  • Household-aware cooking brain: pantry, meal suggestions, dietary safety, recipes, shopping lists.

  • Search structured recipes, scale servings, match pantry ingredients, and build shopping lists.

    1
  • Search, read, and edit your Halite recipe collection and shopping lists.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to interact with Mealie for recipe management, meal planning, and shopping list operations. Supports searching and managing recipes, creating meal plans, and generating shopping lists from recipes or meal plans.
    7
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    A MCP server for Mealie recipe management. Exposes 43 tools and 1 prompt for AI assistants to search, create, and manage recipes, meal plans, shopping lists, categories, and tags.
    1,585 npm
    10
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to manage recipes, meal plans, and shopping lists in Mealie through natural language, supporting CRUD operations and URL-based recipe imports.
    27
    98 npm
    7
    MIT