Skip to main content
Glama

mealie-mcp

Mealie(셀프 호스팅 레시피 관리자)를 LLM 호출 가능 도구 세트로 노출하는 Model Context Protocol 서버입니다. Claude Desktop / Claude Code(또는 모든 MCP 클라이언트)를 통해 자신의 Mealie 인스턴스에서 레시피를 검색하고, 세부 정보를 가져오고, 식단을 관리하며, 쇼핑 목록을 편집할 수 있습니다.

도구

도구

목적

search_recipes(query?, tags?, limit?)

레시피 검색; 슬러그, 이름, 설명, 태그, 카테고리 반환

get_recipe(slug)

슬러그에 대한 전체 레시피 JSON

list_meal_plan(start_date, end_date)

두 ISO 날짜 사이의 식단 계획 항목

list_shopping_lists()

모든 쇼핑 목록의 ID 및 이름

add_shopping_list_items(list_id, items[])

목록에 자유 텍스트 항목 추가

create_recipe(name)

빈 레시피 생성; 생성된 슬러그 반환

create_meal_plan_entry(date, entry_type, recipe_slug?, title?)

식단 계획 항목 추가

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 인스턴스의 기본 URL (예: http://localhost:9011 또는 http://mealie:9000)

MEALIE_API_TOKEN

Mealie에서 발급받은 장기 유지 베어러 토큰

MCP_TRANSPORT

아니요

sse

로컬 하위 프로세스의 경우 stdio, HTTP 스트리밍의 경우 sse

MCP_HOST

아니요

0.0.0.0

SSE 모드용 바인딩 주소

MCP_PORT

아니요

8000

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-mcp

SSE 엔드포인트는 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-mcpPATH에 없는 경우, 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/sse

SSE 이벤트 스트림이 열리는 것을 볼 수 있습니다. 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

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables 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.
    5
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    A 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.
    91
    6
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to manage recipes, meal plans, and shopping lists in Mealie through natural language, supporting CRUD operations and URL-based recipe imports.
    27
    1,621
    8
    MIT

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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