mdlopresti/mealie-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

6 stars 7 forks 质量 67 趋势 14MIT

Repository Install

Model Context Protocol (MCP) server for Mealie recipe management, meal planning, and shopping lists

概览

A Model Context Protocol (MCP) server that enables AI assistants to interact with Mealie for recipe management, meal planning, and shopping lists. - mealie_recipes_search - Search recipes by name, tags, or categories - mealie_recipes_get - Get full recipe details including ingredients and instructions - mealie_recipes_list - List all recipes with pagination - mealie_recipes_create - Create a new recipe - mealie_recipes_create_from_url - Import recipe by scraping a URL - mealie_recipes_update - Update an existing recipe - mealie_recipes_update_structured_ingredients - Update recipe with structured ingredients from parser - mealie_recipes_delete - Delete a recipe - mealie_mealplans_list - List meal plans for a date range - mealie_mealplans_today - Get today's meals - mealie_mealplans_get - Get specific meal plan entry - mealie_mealplans_get_date - Get meals for a specific date - mealie_mealplans_create - Create meal plan entry - mealie_mealplans_update - Update meal plan entry -...

README

以下为原文 README 节选，完整内容请查看原文。

Mealie MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with Mealie for recipe management, meal planning, and shopping lists.

Features

Tools (31 total)

Recipes

mealie_recipes_search - Search recipes by name, tags, or categories
mealie_recipes_get - Get full recipe details including ingredients and instructions
mealie_recipes_list - List all recipes with pagination
mealie_recipes_create - Create a new recipe
mealie_recipes_create_from_url - Import recipe by scraping a URL
mealie_recipes_update - Update an existing recipe
mealie_recipes_update_structured_ingredients - Update recipe with structured ingredients from parser
mealie_recipes_delete - Delete a recipe

Meal Planning

mealie_mealplans_list - List meal plans for a date range
mealie_mealplans_today - Get today’s meals
mealie_mealplans_get - Get specific meal plan entry
mealie_mealplans_get_date - Get meals for a specific date
mealie_mealplans_create - Create meal plan entry
mealie_mealplans_update - Update meal plan entry
mealie_mealplans_delete - Delete meal plan entry
mealie_mealplans_random - Get random meal suggestion

Shopping Lists

mealie_shopping_lists_list - List all shopping lists
mealie_shopping_lists_get - Get shopping list with items
mealie_shopping_lists_create - Create new shopping list
mealie_shopping_lists_delete - Delete shopping list
mealie_shopping_items_add - Add item to list
mealie_shopping_items_add_bulk - Add multiple items at once
mealie_shopping_items_check - Mark item checked/unchecked
mealie_shopping_items_delete - Remove item from list
mealie_shopping_add_recipe - Add recipe ingredients to list
mealie_shopping_generate_from_mealplan - Generate shopping list from meal plan
mealie_shopping_clear_checked - Clear all checked items

Ingredient Parsing

mealie_parser_ingredient - Parse single ingredient string to structured format
mealie_parser_ingredients_batch - Parse multiple ingredient strings at once

Resources

recipes://list - Browse all recipes
recipes://{slug} - View specific recipe
mealplans://current - Current week’s meal plan
mealplans://today - Today’s meals
mealplans://{date} - Specific date’s meals
shopping://lists - All shopping lists
shopping://{list_id} - Specific shopping list

Prerequisites

Docker (or Podman)
A running Mealie instance
Mealie API token

Quick Start

1. Get the Docker Image

在 GitHub 查看完整 README

安装

docker run -i --rm -e MEALIE_URL=https://your-mealie-instance.com -e MEALIE_API_TOKEN=your-api-token-here ghcr.io/mdlopresti/mealie-mcp:latest

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "mealie": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MEALIE_URL=https://your-mealie-instance.com",
        "-e", "MEALIE_API_TOKEN=your-api-token-here",
        "ghcr.io/mdlopresti/mealie-mcp:latest"
      ]
    }
  }
}