mealie-mcp-server

Mealie レシピ管理のための Model Context Protocol (MCP) サーバーです。AI アシスタントがレシピ、献立、買い物リスト、カテゴリ、タグ、フードを検索・作成・管理するための 53 のツールと 1 つのプロンプトを提供します。

特徴

• レシピ管理 — レシピの検索、作成、パッチ適用、複製、削除。制限付き並行処理による複数レシピの一括取得。

• 食材ベースのレシピ発見 — find_recipes_for_ingredients は、人間が読める食材名（Mealie のフード UUID ではなく）を Mealie のフード分類体系に対して解決し、Mealie の Recipe Finder を介して一致するレシピを検索します。正確なフードの一致がない場合は通常のレシピ検索にフォールバックします。「X で何が作れるか」というスタイルの発見に有用で、Mealie がその正確な名前で知らない食材も扱えます（呼び出し側の LLM が代替語で検索を広げます。MCP 自体が代替を推測することはありません）。Workflows の 食材によるレシピ検索 を参照してください。

• レシピのカテゴリ・タグ割り当て — 既存のレシピにカテゴリとタグをマージ/置換セマンティクス、名前/slug/ID 解決、欠落値の自動作成オプション付きで割り当てます。食材、手順、栄養情報、その他のレシピフィールドには影響しません。patch_recipe、update_recipe_taxonomy、update_recipe_taxonomy_batch で利用できます。Workflows の カテゴリ・タグの割り当て を参照してください。

• 献立管理 — 献立の閲覧、作成、一括作成。複合ツールは、並行バッチリクエストを使用してレシピ詳細（栄養情報を含む）を埋め込んだ献立を取得し、N+1 クエリを排除します。

• 買い物リスト — リストとアイテムの完全な CRUD、一括操作、レシピからリストへの統合。

• カテゴリとタグ — レシピ整理のための完全な CRUD。空のカテゴリ/タグの検出を含みます。

• フード — フード分類体系（再利用可能な構造化食材エンティティ）の完全な CRUD。エイリアス管理とフードラベル割り当てを含みます。Workflows の フードの解決または作成 を参照してください。

• 構造化食材の書き込み — update_recipe_ingredients は、すでに解決済みのフード/単位参照を使用して、レシピの完全な構造化食材コレクションを置き換えます。他のレシピフィールドには影響しません。Workflows の 構造化レシピ食材の更新 を参照してください。

• バッチ・複合ツール — 制限付き並行処理によるレシピ検索の get_recipes_batch と get_recipes_detailed_batch、レシピデータを埋め込んだ献立とクライアント側日付フィルタリングの get_mealplan_with_recipes、多数のレシピに対する制限付き並行処理のカテゴリ/タグ更新の update_recipe_taxonomy_batch。

• レシピ分類フィード — get_recipes_for_classification は、AI 駆動のカテゴリ/タグ割り当てに特化した、コンパクトでページング対応の読み取り専用フィードです。安価なリストエンドポイントでフィルタリングし、一致したものだけに上記と同じ制限付き並行処理フェッチで完全な詳細を取得し、同時の分類編集でも生存する安定したカーソルでページングすることで、大規模なレシピセットでバッチ/詳細ツールがタイムアウトする問題を回避します。Workflows の レシピ分類ワークフロー を参照してください。

• SDK 以外のランタイム依存関係ゼロ — ネイティブの fetch を使用し、axios や httpx は不要です。

Related MCP server: mcp-mealie

要件

• Node.js >= 22

• API キーを持つ実行中の Mealie インスタンス

インストール

クイックスタート（npx）

MEALIE_BASE_URL=https://your-mealie-instance.com \
MEALIE_API_KEY=your-api-key \
npx mealie-mcp-server

opencode 設定

opencode.json に追加します:

{
  "mcp": {
    "mealie-mcp-server": {
      "type": "local",
      "command": ["npx", "mealie-mcp-server"],
      "enabled": true,
      "environment": {
        "MEALIE_BASE_URL": "https://your-mealie-instance.com",
        "MEALIE_API_KEY": "your-api-key"
      }
    }
  }
}

Docker

コンテナで MCP サーバーを実行します:

docker run -d \
  --name mealie-mcp-server \
  -e MEALIE_BASE_URL=https://your-mealie-instance.com \
  -e MEALIE_API_KEY=your-api-key \
  ghcr.io/timo-reymann/mealie-mcp-server:main

または Docker Compose を使用:

version: '3.8'
services:
  mealie-mcp-server:
    image: ghcr.io/timo-reymann/mealie-mcp-server:main
    environment:
      MEALIE_BASE_URL: https://your-mealie-instance.com
      MEALIE_API_KEY: your-api-key
    restart: unless-stopped

ローカル開発

git clone https://github.com/timo-reymann/mealie-mcp-server.git
cd mealie-mcp-server
corepack enable
yarn install
cp .env.template .env
# Edit .env with your MEALIE_BASE_URL and MEALIE_API_KEY
yarn dev

環境または opencode 設定で MEALIE_BASE_URL と MEALIE_API_KEY が設定されていることを確認してください。

ドキュメント

• API カバレッジ — 各ツールを基盤となる Mealie API エンドポイントにマッピング。

• ワークフロー — より複雑なツール（食材発見、分類体系の割り当て、フード、構造化食材の書き込み、レシピ分類フィード）の使用ガイドとサンプルペイロード。

• アーキテクチャ — コントリビューター向けの内部設計メモ: 制限付き並行処理の根拠、ページング/カーソル設計、既知の Mealie API の癖。

コントリビューター

あなたの意見を歓迎します！コントリビューションガイドライン を読んで始めましょう。

コントリビューターのリストに載りたいですか？

コントリビューションガイドライン を読んで始めましょう。

開発

要件

• Node.js >= 22

• Yarn（Corepack 経由: corepack enable）

• 統合テスト用の Mealie インスタンス（または fetch レイヤーのモック）

テスト

yarn test

型チェック

yarn typecheck

ビルド

yarn build

リント

yarn lint

利用可能なツール（全 53 個）

レシピ（16）

get_recipes、find_recipes_for_ingredients、get_recipe_detailed、get_recipe_concise、get_recipes_batch、get_recipes_detailed_batch、get_recipes_for_classification、create_recipe、patch_recipe、update_recipe_ingredients、update_recipe_taxonomy、update_recipe_taxonomy_batch、duplicate_recipe、mark_recipe_last_made、set_recipe_image_from_url、delete_recipe

献立（5）

get_all_mealplans、get_mealplan_with_recipes、create_mealplan、create_mealplan_bulk、get_todays_mealplan

カテゴリ（7）

get_categories、get_empty_categories、create_category、get_category、get_category_by_slug、update_category、delete_category

タグ（7）

get_tags、get_empty_tags、create_tag、get_tag、get_tag_by_slug、update_tag、delete_tag

買い物リスト（13）

get_shopping_lists、create_shopping_list、get_shopping_list、update_shopping_list、delete_shopping_list、add_recipe_to_shopping_list、remove_recipe_from_shopping_list、get_shopping_list_items、create_shopping_list_item、create_shopping_list_items_bulk、update_shopping_list_item、delete_shopping_list_item、delete_shopping_list_items_bulk

フード（5）

get_foods、get_food、create_food、update_food、delete_food

ライセンス

MIT