Recipes Plugin

Search and retrieve cooking recipes from your own collection and external sources

CLI

Import the example recipe

$ npx recipes import https://raw.githubusercontent.com/edgestream/recipes-plugin/main/examples/spaghetti-carbonara.json
spaghetti-carbonara

List the recipes in the collection

$ npx recipes list
spaghetti-carbonara: Spaghetti Carbonara with Guanciale and Pecorino

Search through the collection

$ npx recipes search Spaghetti
recipes://personal/spaghetti-carbonara: Spaghetti Carbonara with Guanciale and Pecorino

Show a complete recipe document

$ npx recipes show spaghetti-carbonara
{
  "@context": "https://schema.org",
  "@type": "Recipe",
  "@id": "https://github.com/edgestream/recipes-plugin/blob/main/examples/spaghetti-carbonara.json",
  "name": "Spaghetti Carbonara with Guanciale and Pecorino",
  ...
}

Delete a recipe you no longer want to keep

$ npx recipes delete spaghetti-carbonara
spaghetti-carbonara

Development

Install dependencies, type-check the workspace, and run the test suite

npm install
npm run build
npm run check
npm test

npm run build creates self-contained Node bundles in dist/: recipes-mcp.mjs for the plugin runtime, recipes-mcp-http.mjs for optional single-user Streamable HTTP deployments, and recipes-cli.mjs for the CLI. In the workspace, npx recipes <command> runs the compiled CLI. Set RECIPES_DATA_DIRECTORY to use a collection outside the current directory.

For a local Streamable HTTP MCP endpoint, run RECIPES_DATA_DIRECTORY=/path/to/recipes node ./dist/recipes-mcp-http.mjs and connect to http://127.0.0.1:3000/mcp. Remote exposure requires HTTPS and an authenticated proxy or tunnel; see docs/MCP.md.

Provider package design and contribution guidance is in docs/PROVIDER.md.