Mealie(셀프 호스팅 레시피 관리자)를 LLM 호출 가능 도구 세트로 노출하는 Model Context Protocol 서버입니다. Claude Desktop / Claude Code(또는 모든 MCP 클라이언트)를 통해 자신의 Mealie 인스턴스에서 레시피를 검색하고, 세부 정보를 가져오고, 식단을 관리하며, 쇼핑 목록을 편집할 수 있습니다.
도구 | 목적 |
| 레시피 검색; 슬러그, 이름, 설명, 태그, 카테고리 반환 |
| 슬러그에 대한 전체 레시피 JSON |
| 두 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의 구성 파일을 편집하십시오 (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을 다시 시작하십시오.
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 APIMIT
This server cannot be deployed
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.
Search, read, and edit your Halite recipe collection and shopping lists.
