mealie-mcp
mealie-mcp
Сервер Model Context Protocol, который предоставляет Mealie — self-hosted менеджер рецептов — в виде набора инструментов, вызываемых LLM. Он позволяет Claude Desktop / Claude Code (или любому другому MCP-клиенту) искать рецепты, получать подробную информацию, управлять планом питания и редактировать списки покупок в вашем экземпляре Mealie.
Инструменты
Инструмент | Назначение |
| Поиск рецептов; возвращает слаг, название, описание, теги, категории |
| Полный JSON рецепта по слагу |
| Записи плана питания между двумя датами в формате ISO |
| ID и названия всех списков покупок |
| Добавление текстовых элементов в список |
| Создание пустого рецепта; возвращает сгенерированный слаг |
| Добавление записи в план питания |
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Переменная | Обязательно | По умолчанию | Описание |
| да | — | Базовый URL вашего экземпляра Mealie (например, |
| да | — | Долгосрочный токен доступа (bearer token) из Mealie |
| нет |
|
|
| нет |
| Адрес привязки для режима SSE |
| нет |
| Порт для режима 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-mcpSSE-эндпоинт доступен по адресу 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
This server cannot be deployed
Maintenance
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.
1Search, read, and edit your Halite recipe collection and shopping lists.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.7MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with Mealie recipe databases, allowing users to manage and query their recipes through natural language conversations.22 npmMIT
- AlicenseNot gradedqualityAmaintenanceA 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 npm10MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage recipes, meal plans, and shopping lists in Mealie through natural language, supporting CRUD operations and URL-based recipe imports.2798 npm7MIT