Mealie MCPサーバー

Mealie 用のコミュニティ向けModel Context Protocol (MCP) サーバーです。

ストリーミング可能なHTTPまたはstdioを通じて、Mealieのレシピ、食事プラン、買い物リスト、食品、単位、タグ、カテゴリ、およびレシピツールをMCPクライアントに公開します。

機能

• レシピの検索、作成、パッチ、更新、複製、URL/HTML/ZIP/画像インポート、アセット、画像、タイムラインイベント、コメント、エクスポート、提案、最終作成日の更新

• 世帯の食事プランエントリ、今日の食事、ランダムな食事エントリ、食事プランのルール

• Mealie v3の世帯買い物リスト、買い物アイテムのCRUD、一括アイテム変更、レシピからリストへの操作、ラベル設定

• 食品および単位のマスターデータ（エイリアス、複数形名、重複食品の統合、重複単位の統合を含む）

• タグ、カテゴリ、レシピツール/調理器具、クックブック、コメント、共有リンク、パーサー、メディア、ユーザー、グループ、世帯、探索エンドポイント、管理エンドポイント

• ヘルスチェックエンドポイントと非rootコンテナユーザーを備えたDockerファーストのデプロイメント

Related MCP server: Mealie MCP Server

要件

• Mealie v3.x

• Mealie APIトークン

• Docker、Docker Compose、またはPython 3.12以上

• ストリーミング可能なHTTPまたはstdioをサポートするMCPクライアント

Dockerによるクイックスタート

docker run -d \
  --name mealie-mcp \
  --restart unless-stopped \
  -p 8080:8080 \
  --add-host=host.docker.internal:host-gateway \
  -e MEALIE_BASE_URL=http://your-mealie-instance:9000 \
  -e MEALIE_API_TOKEN=your-mealie-api-token \
  ghcr.io/nikopol666/mealie-mcp:latest

ヘルスチェック:

curl http://localhost:8080/health

MCPエンドポイント:

http://localhost:8080/mcp

Docker Compose

サンプル環境ファイルをコピーし、MealieのURLとAPIトークンを入力してからサービスを開始します:

cp .env.example .env
docker compose up -d

デフォルトのシングルサービス例については、docker-compose.yml を参照してください。

既存のMealie Dockerネットワークに接続する場合は、docker-compose.integration.yml を参照してください。

services:
  mealie-mcp:
    image: ghcr.io/nikopol666/mealie-mcp:latest
    restart: unless-stopped
    ports:
      - "${MCP_HTTP_PORT:-8080}:8080"
    environment:
      MEALIE_BASE_URL: ${MEALIE_BASE_URL:?Set MEALIE_BASE_URL in .env}
      MEALIE_API_TOKEN: ${MEALIE_API_TOKEN:?Set MEALIE_API_TOKEN in .env}

設定

.env.example を .env にコピーし、MealieのURLとAPIトークンを入力します。

MCPクライアントのセットアップ

ストリーミング可能なHTTP

クライアントがストリーミング可能なHTTPをサポートしている場合は、このエンドポイントを使用します:

http://localhost:8080/mcp

同じDockerネットワーク内:

http://mealie-mcp:8080/mcp

Stdio

MCPサーバーをローカルプロセスとして起動するクライアントの場合:

git clone https://github.com/nikopol666/mealie-mcp.git
cd mealie-mcp
python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
export MEALIE_BASE_URL=http://localhost:9000
export MEALIE_API_TOKEN=your-mealie-api-token
python src/main.py --transport stdio

ツール対応範囲

ツールの完全なリストとペイロードの注意点については、docs/TOOL_REFERENCE.md を参照してください。

主なグループ:

• ヘルス

• レシピ

• 食事プラン

• 買い物リスト

• 食品と単位

• タグ、カテゴリ、レシピツール

• クックブック、コメント、共有リンク、パーサー、メディア、ユーザー、グループ、世帯、探索、管理ツール

開発

git clone https://github.com/nikopol666/mealie-mcp.git
cd mealie-mcp
python -m venv .venv
. .venv/bin/activate
pip install -r requirements-dev.txt
PYTHONPATH=src MEALIE_API_TOKEN=test-token pytest -q

実際のMealieインスタンスに対するオプションの読み取り専用スモークチェック:

export MEALIE_LIVE_SMOKE=1
export MEALIE_BASE_URL=http://localhost:9000
export MEALIE_API_TOKEN=your-mealie-api-token
PYTHONPATH=src pytest tests/test_live_smoke.py -q

ストリーミング可能なHTTPで実行:

export MEALIE_BASE_URL=http://localhost:9000
export MEALIE_API_TOKEN=your-mealie-api-token
python src/main.py --transport streamable-http

Dockerイメージのビルド:

docker build -t mealie-mcp:local .

ドキュメント

• デプロイメントガイド

• ツールリファレンス

• 食事プランニングガイド

• 例

• 変更履歴

• 貢献ガイド

• サポートガイド

• セキュリティポリシー

セキュリティに関する注意点

• MEALIE_API_TOKEN は機密情報として扱ってください。

• コンテナは信頼できるネットワーク上、または認証の背後でのみ実行してください。

• MCPサーバーは、設定されたMealieトークンの権限を使用してMealieデータの作成、更新、削除を行うことができます。

• 可能であれば、このサービス専用のMealie APIトークンを使用してください。 開示およびデプロイメントのガイダンスについては SECURITY.md を参照してください。

互換性

このプロジェクトは現在のMealie v3 APIを対象としています。Mealieは時間の経過とともに一部のリソースをグループスコープと世帯スコープ間で移動させています。Mealieのアップグレード後にツールが失敗した場合は、失敗したエンドポイントとインスタンスの /openapi.json を比較してください。

ライセンス

MIT