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:
uvproject on Python 3.12,ruff(lint and format), strictmypy,pytestwith coverage,pre-commit,maketargets and a CI workflow. alhorno-mcp sync: downloads the upstreamrecipes.json, validates every record with Pydantic and writes the snapshot atomically.--checkreports 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 fromrecipes.jsonat 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.mjsregenerates them from a website checkout. - Absolute URL helpers matching the site: recipe pages, image URLs and search URLs with
URLSearchParams-compatible encoding. alhorno-mcp servewith six read-only MCP tools onmcp==2.3.0MCPServer:search_recipes,get_recipe,list_tags,find_recipes_by_ingredients,get_related_recipesandrandom_recipe. Every tool has a website equivalent.- Two transports:
stdiofor local hosts andstreamable-httpwith a host allowlist (TransportSecuritySettings), stateless mode and aGET /healthendpoint 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 actionableConfigErrormessages.
Changed¶
- Tags are compared by identity, exactly as the website does (
pollodoes not matchPollo). An unknown tag or ingredient is rejected with close-match suggestions instead of silently returning an empty page. - Recipe
idis serialized as a string so 19-digit identifiers survive JavaScript clients;slugis the recommended key andrawkeeps 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.