mealie-mcp
mealie-mcp
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 구성
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 installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
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.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with Mealie recipe databases, allowing users to manage and query their recipes through natural language conversations.16MIT
- 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.916MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage recipes, meal plans, and shopping lists in Mealie through natural language, supporting CRUD operations and URL-based recipe imports.271,6218MIT
Related MCP Connectors
Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Bounded tools for rendering, extraction, RAG, enrichment, local discovery and review analysis.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/eds3028/mealie-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server