Skip to content

Repository files navigation

gousto-mcp

A MCP server for Gousto recipes

Description

This is a simple MCP server for Gousto recipes. It allows you to search for recipes by title and get details about a recipe by its UID.

It uses @huggingface/transformers (Xenova/bge-small-en-v1.5) to generate local embeddings for recipe titles, stored in a sqlite-vec vector database for semantic search.

Usage

You can add the server to Home Assistant using the Model Context Protocol integration. Then you can ask the LLM conversation agent for information about recipes.

image

Tools

search_recipes

Search for recipes by title using semantic vector search.

get_recipe

Get details about a recipe by its UID.

Dev

First, install dependencies:

npm install

Scrape all recipe titles from the Gousto API and save to data/recipes.json:

npm run scrape

Generate embeddings for each recipe title and store them in the SQLite vector database:

npm run embed

Then start the server:

npm run start

Or build a Docker image:

docker buildx build --push --platform linux/arm64/v8,linux/amd64 --tag threesquared/gousto-mcp:latest .
docker run -p 3000:3000 threesquared/gousto-mcp

About

A MCP server for Gousto recipes

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages