Pour les développeurs

Le serveur MCP de Cuisine.eco

Cuisine.eco expose ses données publiques — 62 341 fermes en agriculture biologique, les recettes de saison et les aliments du mois — sous forme d'outils MCP. Un assistant IA peut ainsi répondre à « quels maraîchers bio près de Lyon ? » ou « que cuisiner avec ce qui pousse en août ? » en interrogeant directement la source, sans passer par le scraping d'une page web.

Le serveur est public, anonyme et en lecture seule. Aucune clé n'est nécessaire : ces données sont déjà consultables sur le site, et exiger une inscription irait contre l'objectif, qui est justement d'être atteignable.

Se connecter

Le serveur parle JSON-RPC sur HTTP (transport Streamable HTTP) à cette adresse :

POST https://cuisine.eco/mcp

Dans un client qui lit un fichier de configuration, comme Claude Desktop : 

{
  "mcpServers": {
    "cuisine-eco": {
      "url": "https://cuisine.eco/mcp"
    }
  }
}

Pour vérifier depuis un terminal, sans aucun client : 

curl -X POST https://cuisine.eco/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Les outils

5 outils, tous en lecture seule. Cette liste est produite à partir des définitions réellement servies par le serveur : elle ne peut pas décrire un outil qui n'existe pas.

search_producers

Recherche des producteurs bio francais par nom, code postal ou zone geographique. Donnees issues de l'Agence Bio et de l'INSEE.

q string — facultatif
Nom du producteur ou de la ferme, meme partiel
postal_code string — facultatif
Code postal francais a 5 chiffres
bbox string — facultatif
Zone geographique, quatre nombres separes par des virgules : sud,ouest,nord,est
limit integer — facultatif
Nombre maximum de resultats (defaut 10, maximum 50)

get_producer

Recupere la fiche complete d'un producteur bio francais a partir de son identifiant (slug). Donnees issues de l'Agence Bio et de l'INSEE.

slug string — obligatoire
Identifiant unique du producteur (visible dans son URL /bio/...)

search_recipes

Recherche des recettes de chef par titre, mois de saison ou categorie. Ne porte que sur les recettes publiques (jamais les recettes d'un compte).

q string — facultatif
Titre de la recette, meme partiel
month integer — facultatif
Mois de saison, de 1 (janvier) a 12 (decembre)
category string — facultatif
Nom de la categorie de recette (ex: Soupes)
limit integer — facultatif
Nombre maximum de resultats (defaut 10, maximum 50)

get_recipe

Recupere le detail d'une recette de chef a partir de son identifiant. Ne porte que sur les recettes publiques (jamais les recettes d'un compte).

id integer — obligatoire
Identifiant de la recette

list_seasonal_foods

Liste les aliments de saison pour un mois donne. Ne porte que sur les aliments publics (jamais les aliments d'un compte).

month integer — facultatif
Mois de saison, de 1 (janvier) a 12 (decembre)

Limites

  • Lecture seule. Aucun outil ne crée, ne modifie ni ne supprime quoi que ce soit.
  • Données publiques uniquement. Rien de ce qui appartient à un compte utilisateur n'est atteignable, et une fiche producteur non publiée ne sort pas du serveur.
  • Pagination plafonnée. Les recherches renvoient 10 résultats par défaut, 50 au maximum.
  • Débit limité. Le serveur est anonyme mais pas illimité ; au-delà d'une soixantaine d'appels par minute, les requêtes sont refusées.

D'où viennent les données

Les fiches producteurs sont construites à partir des données publiques de l'Agence Bio et de l'INSEE. La page sources et licences détaille précisément quelle donnée vient d'où, ce que nous refusons d'afficher, et comment corriger une fiche.

Si votre assistant cite une ferme ou une recette, il devrait citer l'URL renvoyée par l'outil : chaque résultat en contient une, absolue et directement ouvrable.