Сервер Model Context Protocol (MCP), который соединяет AI-ассистентов с вашими База данных рецептов муки через клиентов например, Claude Desktop.

Содержание

• Особенности
• Быстрый старт
• Конфигурация
• Удалённый доступ
• Docker
• Примеры использования
• Доступные инструменты
• Разработка
• Важные заметки
• Поддержка и вклад
• Лицензия и кредиты

Особенности

• Рецепты: Создавать, читать, обновлять, импортировать, дублировать и удалять рецепты.
• Поиск: Фильтруйте по тексту, категориям, тегам и инструментам с помощью логики AND/OR.
• Изображения и ресурсы: Загружать изображения и файлы рецептов или устанавливать изображения по URL.
• Питание и отмещение: Установите питание за порцию и видимость рецепта такие настройки, как showAssets и showNutrition.
• Ингредиенты: Разрешите свободный текст ингредиентов с едой и единицей Мили Словарный запас.
• Списки покупок: Управление списками и товарами, выполнение массовых операций и добавление Ингредиенты рецепта с масштабированием количества.
• Организация: Управление категориями, тегами, продуктами, единицами и инструментами для рецептов; поиск Неиспользуемые категории и теги.
• Планирование питания: Просматривать, создавать, обновлять и удалять записи плана питания, создавать Множество записей и отмечайте рецепты как сделанные сегодня.

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

Mealie MCP Server

A Model Context Protocol (MCP) server that connects AI assistants to your Mealie recipe database through clients such as Claude Desktop.

Contents

• Features
• Quick Start
• Configuration
• Remote Access
• Docker
• Usage Examples
• Available Tools
• Development
• Important Notes
• Support and Contributing
• License and Credits

Features

• Recipes: Create, read, update, import, duplicate, and delete recipes.
• Search: Filter by text, categories, tags, and tools with AND/OR logic.
• Images and assets: Upload recipe images and files, or set images from URLs.
• Nutrition and display: Set per-serving nutrition and recipe visibility settings such as showAssets and showNutrition.
• Ingredients: Resolve free-text ingredients against Mealie’s food and unit vocabulary.
• Shopping lists: Manage lists and items, perform bulk operations, and add recipe ingredients with quantity scaling.
• Organization: Manage categories, tags, foods, units, and recipe tools; find unused categories and tags.
• Meal planning: View, create, update, and delete meal plan entries, create multiple entries, and mark recipes as made today.

Quick Start

Prerequisites

• Python 3.12+
• A running Mealie instance and an API key from your account settings
• Package manager uv

Installation

Option 1: Using the MCP SDK CLI (Recommended)

Clone the repository, then install the server into Claude Desktop with the mcp command supplied by the Python MCP SDK (no standalone fastmcp package is needed):

git clone https://github.com/rldiao/mealie-mcp-server.git
cd mealie-mcp-server
uv sync --locked
uv run mcp install src/server.py --with-editable . \
  --env-var MEALIE_BASE_URL=https://your-mealie-instance.com \
  --env-var MEALIE_API_KEY=your-mealie-api-key

Option 2: Using uvx

Add this to your MCP client’s configuration to run directly from GitHub without cloning (in Claude Desktop, use claude_desktop_config.json):

{
  "mcpServers": {
    "mealie-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/rldiao/mealie-mcp-server",
        "mealie-mcp-server"
      ],
      "env": {
        "MEALIE_BASE_URL": "https://your-mealie-instance.com",
        "MEALIE_API_KEY": "your-mealie-api-key"
      }
    }
  }
}

Restart Claude Desktop to load the server.

Configuration

Set environment variables in your MCP client configuration or shell. For a local