cooklang-mcp-server

Un pequeño servidor FastMCP que expone el servidor de recetas CookCLI (cook server, incluido en ghcr.io/cooklang/cookcli) a un agente de codificación como herramientas MCP. Con él, un agente puede explorar, leer, escribir, eliminar y buscar recetas Cooklang a través de la API HTTP de CookCLI.

¿Necesitas esto?

Usa este servidor cuando se accede a las recetas a través de HTTP: un cook server ejecutándose en otra máquina o en un NAS, o un cliente MCP como Claude Desktop que no tiene acceso al shell.

Si tus recetas son archivos locales y el agente puede ejecutar comandos (Claude Code, Codex), el plugin oficial cooklang-skills es la mejor opción. Maneja el CLI de cook directamente y abarca más: planificación de comidas, seguimiento de despensa, listas de compra agrupadas por pasillo, exportaciones.

Related MCP server: Nextcloud Cookbook MCP Server

Cómo funciona

Cada herramienta MCP se corresponse 1:1 con un endpoint HTTP de CookCLI (read_recipe -> GET /api/recipes/{path}, y así sucesivamente). Este servidor es un adaptador sin estado: no almacena datos, no realiza análisis y requiere un proceso cook server independiente en ejecución (consulta Requisitos). Todas las recetas residen en el directorio de recetas de CookCLI.

Herramientas

path es relativo al directorio de recetas del servidor CookCLI, p. ej., Dolci/bunet-piemontese (la extensión .cook es opcional). write_recipe requere que la carpeta pad re ya exista y escriba de forma atómica (archivo temporal + renombrado). Las imágenes de títuo no se pueden escribir vía HTTP: colócalas junto al archivo .cook en el directorio de recetas (o en el volúmen de Docker).

Requisitos

• Python >= 3.10 y uv

• Un servidor CookCLI en ejecución, por ejemplo:

  docker run -d --name cooklang-cookcli-1 -p 9080:9080 \
    -v cooklang_recipes:/recipes \
    ghcr.io/cooklang/cookcli server --host 0.0.0.0 /recipes

  o, con CookCLI instalado localmente, cook server ./my-recipes.

Registro con Claude Code

No es necesario clonar nada. uvx obtiene, compila y almacena en caché el servidor directa desde este repositorio:

claude mcp add cooklang \
  --env COOKLANG_SERVER_URL=http://localhost:9080 \
  -- uvx --from git+https://github.com/alessmar/cooklang-mcp-server cooklang-mcp-server

O en .mcp.json / ~/.claude.json:

{
  "mcpServers": {
    "cooklang": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/alessmar/cooklang-mcp-server",
               "cooklang-mcp-server"],
      "env": { "COOKLANG_SERVER_URL": "http://localhost:9080" }
    }
  }
}

COOKLANG_SERVER_URL usa por defecto http://localhost:9080. Fija una versión añadiendo @<tag> a la URL del repositorio git, p. ej., ...cooklang-mcp-server@v0.1.0.

Desarrollo local

git clone https://github.com/alessmar/cooklang-mcp-server
cd cooklang-mcp-server
uv sync
COOKLANG_SERVER_URL=http://localhost:9080 uv run cooklang-mcp-server

Notas

• El servidor CookCLI no tiene autenticación y tiene CORS abierto: mantenlo en localhost o en una LAN de confianza.

• /api/reload no hace nada en el CookCLI actual: el servidor lee del disco en cada petición, por lo que los cambios en archivos realizados fuea de la API se detectan de inmediato.

Licencia

MIT. Consulta LICENSE.