Skip to content

Changelog

This page renders the repository's CHANGELOG.md, so it always matches the released history. The full file, with links to compare releases, lives at github.com/FedeG/al_horno_con_papa_mcp/blob/main/CHANGELOG.md.

All notable changes to this project are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

  • Repository tooling: uv project on Python 3.12, ruff (lint and format), strict mypy, pytest with coverage, pre-commit, make targets and a CI workflow.
  • alhorno-mcp sync: downloads the upstream recipes.json, validates every record with Pydantic and writes the snapshot atomically. --check reports whether the stored snapshot is still current without writing it.
  • Committed snapshot of 246 recipes, sha256 b75d119880b3784c2a037608132c87eed5a48ad05f2980407c2dad67ac174ca2.
  • In-memory RecipeDataset: catalog-ordered recipes, slug and id lookup, precomputed related recipes and tag counts, loaded from recipes.json at startup.
  • Faithful port of the website search pipeline (Fuse.js 7.4.2 Bitap): accent folding, multi-token queries, Spanish stopwords and per-token thresholds, reproducing the site's result sets and ordering, plus the "Qué cocino" ingredient matcher.
  • Parity goldens recorded by running the website's own search modules over the same snapshot, so CI needs only Python: 100 search cases and 12 ingredient cases. tools/goldens.mjs regenerates them from a website checkout.
  • Absolute URL helpers matching the site: recipe pages, image URLs and search URLs with URLSearchParams-compatible encoding.
  • alhorno-mcp serve with six read-only MCP tools on mcp==2.3.0 MCPServer: search_recipes, get_recipe, list_tags, find_recipes_by_ingredients, get_related_recipes and random_recipe. Every tool has a website equivalent.
  • Two transports: stdio for local hosts and streamable-http with a host allowlist (TransportSecuritySettings), stateless mode and a GET /health endpoint reporting status, version, recipe and tag counts.
  • Environment-driven Settings (ALHORNO_TRANSPORT, ALHORNO_HOST, ALHORNO_PORT, ALHORNO_PATH, ALHORNO_LOG_LEVEL, ALHORNO_STATELESS_HTTP, ALHORNO_ALLOWED_HOSTS, ALHORNO_ALLOWED_ORIGINS, ALHORNO_SITE_BASE_URL, ALHORNO_DATA_DIR) with validated values and actionable ConfigError messages.

Changed

  • Tags are compared by identity, exactly as the website does (pollo does not match Pollo). An unknown tag or ingredient is rejected with close-match suggestions instead of silently returning an empty page.
  • Recipe id is serialized as a string so 19-digit identifiers survive JavaScript clients; slug is the recommended key and raw keeps the exact upstream number.
  • Hidden recipes are never served, and related recipes that point at a hidden or unknown recipe are dropped instead of leaking its name.
  • The test suite is end-to-end: it drives the tools through an in-memory MCP client and the HTTP transport, and compares the results against the recorded site goldens.