convez.ai
MCP ServerIntegração & APIsIntermediário
cjam

Mealie MCP Server

cjam/mealie-mcp

Integra Claude ao Mealie para automação de receitas e planejamento de refeições

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe a API do Mealie (plataforma de gerenciamento de receitas) como ferramentas Claude. Gerado automaticamente a partir do OpenAPI spec do Mealie via FastMCP, com surface curada para receitas, planos de refeições, listas de compras e metadados relacionados. Permite que Claude acesse e manipule dados de receitas e planejamento de refeições em tempo real.

Instalação

$npx convez-ai cjam/mealie-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Buscar e listar receitas por categoria, tags ou ingredientes
  • Gerar planos de refeições semanais automaticamente
  • Criar e gerenciar listas de compras a partir de receitas
  • Consultar unidades, alimentos cadastrados e organizar receitas

Veredito

Solução prática para conectar Claude ao Mealie sem wrapper manual — geração automática via OpenAPI garante sincronização com atualizações da API. Ideal para quem usa Mealie em NAS/self-hosted e quer automação de planejamento e listas de compras via IA.

README

A tradução para o português deste README ainda está na fila.

mealie-mcp

MCP server for Mealie, generated directly from Mealie's OpenAPI spec via FastMCP. No hand-written endpoint wrappers — tools come from the spec, curated to a meal-planning subset.

How it works

At startup the server:

  1. Fetches ${MEALIE_BASE_URL}/openapi.json from your Mealie instance.
  2. Maps a curated subset of routes to MCP tools (see src/routes.py).
  3. Serves over streamable-HTTP for remote AI clients.

Curated surface (edit INCLUDE_PATTERNS in src/routes.py): recipes, meal plans, shopping lists/items, categories, tags, foods, units. Everything else (admin, users, backups…) is excluded.

Configuration

Copy .env.example to .env:

VarRequiredDefaultNotes
MEALIE_BASE_URLyes—No trailing slash, no /api.
MEALIE_API_TOKENyes—Mealie > User profile > Manage API Tokens.
MCP_HOSTno0.0.0.0
MCP_PORTno8000
MCP_TRANSPORTnohttpstreamable-HTTP.
LOG_LEVELnoINFO

Develop (devcontainer)

Open the repo in VS Code → "Reopen in Container". It builds Python 3.12 + uv, runs uv sync, forwards port 8000. Then:

cp .env.example .env   # fill in MEALIE_BASE_URL + token
uv run src/server.py

Server at http://localhost:8000/mcp.

Deploy (NAS / Docker)

cp .env.example .env   # fill in values
docker compose up -d --build

Point your AI client at http://<nas-host>:8000/mcp.

Connect an MCP client

{
  "mcpServers": {
    "mealie": {
      "url": "http://<nas-host>:8000/mcp"
    }
  }
}
Ver o original no GitHub

Bom para

Relacionados