AIアシスタントをあなたの クライアントを通じたミリーレシピデータベース 例えばClaude Desktopなどです。

内容

• 特徴
• クイックスタート
• 構成
• リモートアクセス
• Docker
• 使用例
• 利用可能なツール
• 開発
• 重要な注記
• 支援と貢献
• ライセンスとクレジット

特徴

• レシピ: レシピの作成、読み取り、更新、インポート、複製、削除。
• 検索: テキスト、カテゴリ、タグ、ツールでAND/ORロジックでフィルタリング。
• 画像とアセット: レシピ画像やファイルをアップロードするか、URLからセット画像を作成してください。
• 栄養と表示: 1食あたりの栄養とレシピの可視性を設定する 例えば、showAssetsやshowNutritionのような設定です。
• 材料: フリーテキストの材料をMealieの食品およびユニットに対して解決する 語彙力。
• ショッピングリスト: リストやアイテムの管理、一括操作、追加 レシピの材料は量をスケーリングします。
• 組織: カテゴリ、タグ、食品、ユニット、レシピツールの管理;検索 未使用カテゴリとタグ。
• 食事計画: 食事プランの項目を閲覧、作成、更新、削除、作成 複数のエントリーがあり、今日作ったレシピをマークしてください。

クイックスタート

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