Créer un agent de recettes : Les 7 outils du serveur MCP de Forktastic

Une fois votre bibliothèque Forktastic connectée à Claude ou Cursor via MCP, la question suivante est de savoir quoi construire avec. Cet article est la référence pour les sept outils que le serveur MCP de Forktastic expose, avec des exemples de requêtes et des exemples de conceptions d'agents.

Les sept outils

search_recipes

Objectif : Recherche en texte intégral dans votre bibliothèque de recettes.

Entrées : query (chaîne de caractères, obligatoire), limit (entier, facultatif, par défaut 20), offset (entier, facultatif, par défaut 0).

Sortie : Tableau de résumés de recettes (id, titre, URL de la photo, URL de la source, étiquettes diététiques).

Cas d'utilisation : "Trouve mes recettes italiennes" — Claude appelle search_recipes avec query="italian".

get_recipe

Objectif : Récupérer la recette complète par ID, y compris les ingrédients, les étapes, les notes, la nutrition.

Entrées : recipe_id (UUID, obligatoire).

Sortie : Objet de recette complet.

Cas d'utilisation : "Lis-moi les étapes de cette recette de pâtes" — Claude appelle get_recipe avec l'ID d'une recherche précédente.

list_cookbooks

Objectif : Lister vos livres de cuisine.

Entrées : limit, offset (facultatif).

Sortie : Tableau de résumés de livres de cuisine (id, nom, nombre de recettes, dernière mise à jour).

Cas d'utilisation : "Quels livres de cuisine ai-je ?"

search_cookbooks

Objectif : Rechercher des livres de cuisine par nom.

Entrées : query (chaîne de caractères).

Sortie : Tableau de résumés de livres de cuisine.

get_cookbook

Objectif : Récupérer un livre de cuisine avec ses recettes.

Entrées : cookbook_id (UUID).

Sortie : Livre de cuisine avec tableau de résumés de recettes.

Cas d'utilisation : "Montre-moi tout ce qu'il y a dans mon livre de cuisine 'Cuisine de grand-mère'."

get_trending

Objectif : Obtenir les recettes les plus populaires sur la plateforme (pas seulement les vôtres).

Entrées : limit (facultatif).

Sortie : Tableau de résumés de recettes populaires.

Cas d'utilisation : "Qu'est-ce qui est populaire en ce moment ?" — utile pour la découverte.

get_family

Objectif : Obtenir les informations de votre groupe familial (membres, livres de cuisine partagés).

Entrées : Aucun (utilise le compte du PAT).

Sortie : Groupe familial avec les membres et la liste des livres de cuisine partagés.

Cas d'utilisation : "Qui est dans mon groupe familial Forktastic ?"

Trois exemples de conceptions d'agents

1. L'agent de planification des repas hebdomadaires

Prompt : "Chaque dimanche, interroge Forktastic pour les recettes que j'ai cuisinées au cours du dernier trimestre. Choisis-en 3 en fonction de : la variété des cuisines, les recettes que je n'ai pas répétées récemment et ce qui est de saison. Sors le résultat en Markdown pour mon application de notes."

Outils utilisés : search_recipes, get_recipe, list_cookbooks.

2. Le chercheur conscient du garde-manger

Prompt : "J'ai du poulet, du brocoli, du riz, de l'ail et de la sauce soja dans mon réfrigérateur. Trouve des recettes de ma bibliothèque Forktastic qui utilisent au moins 3 de ces ingrédients."

Outils utilisés : search_recipes (pour la correspondance des ingrédients), get_recipe (pour vérifier la liste des ingrédients).

3. Le formateur d'exportation vers Markdown

Prompt : "Extrais la recette avec l'ID X de Forktastic et formate-la en Markdown approprié pour être collée dans un message Slack. Incluez l'URL source, les ingrédients sous forme de liste de contrôle et les étapes sous forme de liste numérotée."

Outils utilisés : get_recipe.

Limites de débit à connaître

60 requêtes par minute et 5 000 par jour par jeton. Pour la plupart des charges de travail des agents, c'est suffisant ; pour les opérations à haute fréquence, regroupez vos requêtes. Référence des limites de débit et de la pagination.

Pagination

Les points de terminaison de liste (search_recipes, list_cookbooks, get_trending) utilisent la pagination basée sur le décalage avec les paramètres limit/offset. Limite par défaut 20, max 100. Les dépassements de décalage renvoient des tableaux vides (pas des erreurs).

Où aller ensuite

Pour la configuration, Procédure de connexion à Claude ou Configuration de Cursor. Pour les limites de débit, référence des limites de débit. Pour le pilier MCP, guide du pilier MCP.