mealie-mcp
mealie-mcp
Mealie(セルフホスト型レシピマネージャー)をLLMから呼び出し可能なツールセットとして公開するModel Context Protocolサーバーです。Claude Desktop / Claude Code(またはその他のMCPクライアント)から、自身のMealieインスタンス上のレシピ検索、詳細取得、献立管理、買い物リストの編集が可能になります。
ツール
ツール | 用途 |
| レシピを検索。スラッグ、名前、説明、タグ、カテゴリを返します |
| 指定したスラッグの完全なレシピJSONを取得 |
| 指定した2つのISO日付間の献立エントリを取得 |
| すべての買い物リストのIDと名前を取得 |
| リストにフリーテキストのアイテムを追加 |
| 空のレシピを作成。生成されたスラッグを返します |
| 献立エントリを追加 |
Related MCP server: Mealie MCP Server
要件
Python 3.11以上
稼働中のMealieインスタンス(セルフホスト型。Mealie v2でテスト済み)
長期間有効なMealie APIトークン(Mealie UIの「ユーザープロフィール」→「APIトークン」から取得)
設定
.env.example を .env にコピーし、値を入力してください:
cp .env.example .env変数 | 必須 | デフォルト | 説明 |
| はい | — | MealieインスタンスのベースURL(例: |
| はい | — | Mealieから取得した長期間有効なベアラートークン |
| いいえ |
| ローカルサブプロセス用には |
| いいえ |
| SSEモードのバインドアドレス |
| いいえ |
| SSEモードのバインドポート |
インストールとローカル実行
pip install -e .
# stdio mode (for Claude Desktop):
MCP_TRANSPORT=stdio mealie-mcp
# sse/http mode (for docker-compose / remote clients):
MCP_TRANSPORT=sse MCP_PORT=8000 mealie-mcpSSEエンドポイントは http://<host>:<port>/sse で提供されます。
Claude Desktopの設定
Claude Desktopの設定ファイル(macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json)を編集します:
{
"mcpServers": {
"mealie": {
"command": "mealie-mcp",
"env": {
"MEALIE_URL": "http://localhost:9011",
"MEALIE_API_TOKEN": "paste-your-token-here",
"MCP_TRANSPORT": "stdio"
}
}
}
}mealie-mcp が PATH にない場合は、command にバイナリのフルパスを指定するか(例: /Users/you/.venvs/mealie-mcp/bin/mealie-mcp)、Python経由で呼び出してください:
{
"mcpServers": {
"mealie": {
"command": "python",
"args": ["-m", "mealie_mcp"],
"env": {
"MEALIE_URL": "http://localhost:9011",
"MEALIE_API_TOKEN": "paste-your-token-here",
"MCP_TRANSPORT": "stdio"
}
}
}
}設定を編集した後、Claude Desktopを再起動してください。
Docker / docker-compose
Dockerfile が含まれています。スタンドアロンで実行する場合:
docker build -t mealie-mcp .
docker run --rm -p 8765:8000 \
-e MEALIE_URL=http://host.docker.internal:9011 \
-e MEALIE_API_TOKEN=your-token \
mealie-mcp既存のMealieスタックにサーバーを追加するには、docker-compose.snippet.yml を参照してください:
services:
mealie-mcp:
build:
context: ./mealie-mcp
depends_on:
- mealie
environment:
MEALIE_URL: "http://mealie:9000"
MEALIE_API_TOKEN: "${MEALIE_API_TOKEN}"
MCP_TRANSPORT: "sse"
MCP_HOST: "0.0.0.0"
MCP_PORT: "8000"
ports:
- "8765:8000"MCPクライアントで http://<docker-host>:8765/sse を指定してください。
サーバーの手動テスト
サーバーをSSEモードで実行している状態で、到達可能であることを確認します:
curl -N http://localhost:8000/sseSSEイベントストリームが開くのが確認できるはずです。stdioモードの場合、ハンドシェイクはClaude Desktopが処理するため、HTTPエンドポイントはありません。
プロジェクト構成
mealie-mcp/
├── pyproject.toml
├── Dockerfile
├── docker-compose.snippet.yml
├── .env.example
├── README.md
└── src/mealie_mcp/
├── __init__.py
├── __main__.py # CLI entry point (loads .env, dispatches transport)
├── server.py # FastMCP server + tool definitions
└── client.py # Async httpx wrapper for the Mealie REST APIライセンス
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Scraps Kitchen gives any AI agent a persistent, household-aware kitchen memory. Unlike generic chatbot recall, Scraps maintains structured cooking data: what's in your fridge (with freshness tracking), who you cook for (with allergens, dietary restrictions, and preferences), your recipe collection (with cook notes and per-diner ratings), your shopping list, and your kitchen equipment. 27 tools across 6 domains let agents read kitchen context, suggest meals that respect dietary safety, update the pantry after cooking, and build a history of what works for your household. Every interaction makes the data richer. Cooking history, preference signals, kitchen awareness = better suggestions next time. All tools work via oAuth and a free scraps.kitchen account.
Household-aware cooking brain: pantry, meal suggestions, dietary safety, recipes, shopping lists.
Search structured recipes, scale servings, match pantry ingredients, and build shopping lists.
1Search, read, and edit your Halite recipe collection and shopping lists.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Mealie for recipe management, meal planning, and shopping list operations. Supports searching and managing recipes, creating meal plans, and generating shopping lists from recipes or meal plans.7MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with Mealie recipe databases, allowing users to manage and query their recipes through natural language conversations.22 npmMIT
- AlicenseNot gradedqualityAmaintenanceA MCP server for Mealie recipe management. Exposes 43 tools and 1 prompt for AI assistants to search, create, and manage recipes, meal plans, shopping lists, categories, and tags.1,585 npm10MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage recipes, meal plans, and shopping lists in Mealie through natural language, supporting CRUD operations and URL-based recipe imports.2798 npm7MIT