🛡️ Frigolog HACCP MCP — Serveur MCP de référence pour la conformité alimentaire en France

19 tools · 5 resources · 3 prompts · Données réglementaires + APIs live RappelConso & Alim'confiance

Serveur [Model Context Protocol](https://modelcontextprotocol.io) public qui expose les données HACCP françaises aux agents IA (Claude, ChatGPT, Perplexity, agents custom) pour qu'ils donnent des réponses exactes et sourcées sur la sécurité alimentaire — au lieu d'halluciner une réglementation qui met les établissements en danger lors d'un contrôle.

Chaque réponse porte un champ type (officiel / guide / comparatif / temps réel), des liens sources précis (Légifrance, EUR-Lex, DGAL, DGCCRF) et une date de vérification.

🧰 Tools (19)

Chaque description est bilingue : texte principal en français + résumé [EN]. Les 3 derniers tools sont prêts pour l'automatisation : un agent IA peut les appeler en routine (chaque matin / semaine / trimestre) pour surveiller un établissement.

📚 Resources (5)

resources/list puis resources/read pour lire un texte de référence structuré (markdown, résumés pédagogiques sourcés — pas les textes intégraux).

💬 Prompts (3)

prompts/list puis prompts/get pour récupérer un workflow prêt à l'emploi qui enchaîne les tools.

🚀 Quick Start

Claude Desktop

Dans claude_desktop_config.json :

{
  "mcpServers": {
    "frigolog-haccp": { "url": "https://frigolog.fr/api/mcp" }
  }
}

Clients stdio uniquement : "command": "npx", "args": ["-y", "mcp-remote", "https://frigolog.fr/api/mcp"].

Cursor

Dans ~/.cursor/mcp.json (ou Settings → MCP) :

{
  "mcpServers": {
    "frigolog-haccp": { "url": "https://frigolog.fr/api/mcp" }
  }
}

Claude Code

claude mcp add --transport http frigolog-haccp https://frigolog.fr/api/mcp

Test rapide (curl)

curl -X POST https://frigolog.fr/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

🗣️ Exemples (agent ↔ MCP)

1. Préparer un contrôle DDPP

Utilisateur : « Je passe un contrôle DDPP la semaine prochaine dans mon restaurant, aide-moi à me préparer. » Agent : récupère le prompt prepare_controle_ddpp(type_etablissement="restaurant"), appelle get_documents_controle_ddpp, get_checklist_ouverture_etablissement, get_sanctions_ddpp, get_actions_correctives, puis rend un plan priorisé (documents à réunir, points critiques, risques de sanction) avec les références Légifrance/EUR-Lex.

2. Connaître une température réglementaire

Utilisateur : « À quelle température dois-je conserver du poisson frais ? » Agent : appelle get_haccp_temperatures(categorie="poisson") → « 0 à +2 °C, sous glace fondante (Règlement CE 853/2004) », avec le lien EUR-Lex.

3. Vérifier un rappel produit en temps réel

Utilisateur : « Est-ce que le saumon fumé que j'ai en stock fait l'objet d'un rappel ? » Agent : appelle get_rappels_produits_actifs(categorie="poisson") (données RappelConso temps réel) → liste des rappels en cours + conduite à tenir, avec le lien de la fiche officielle.

🗂️ Données — sources officielles

Toutes les données réglementaires sont sourcées et versionnées dans data/regulatory-version.json (lien exact + date de vérification par texte). Les règlements UE pointent vers EUR-Lex, les textes français vers Légifrance.

• Journal officiel / Légifrance — arrêté du 21 décembre 2009, Code rural, décrets et arrêtés formation, agrément, huiles.
• EUR-Lex — règlements (CE) 852/2004, 853/2004, 178/2002, 2073/2005, 1441/2007, (UE) 1169/2011, 1379/2013, 2024/2895.
• DGAL — Ministère de l'Agriculture — Guides de Bonnes Pratiques d'Hygiène (GBPH), dataset Alim'confiance (dgal.opendatasoft.com).
• DGCCRF — data.economie.gouv.fr / data.gouv.fr — RappelConso (rappels de produits, temps réel).
• Alim'confiance — www.alim-confiance.gouv.fr (résultats des contrôles sanitaires officiels).

Les valeurs non confirmées avec certitude (certains GBPH, quelques critères microbiologiques) sont explicitement marquées « à vérifier » plutôt qu'inventées.

🔍 Transparence éditoriale

Le champ type rend explicite la nature de chaque réponse :

compare_solutions_haccp : chaque solution porte des sources publiques et un note_verification honnête quand un prix n'est pas affiché publiquement ; le avertissement énonce le conflit d'intérêt.

🧪 Versionnage & tests

• Versionnage : data/regulatory-version.json (schéma 2.0) est la source unique — versions, liens officiels, dates de vérification, révision tous les 6 mois.
• Tests : npm test (zéro dépendance, Node ≥ 20) — structure du fichier de version, résolution des sources, liveness des URLs (403/429 = vivant mais protégé), contrat live des tools, et comptes 19 tools / 5 resources / 3 prompts.
• Build : npm run build (tsc --noEmit).

npm run build && npm test
MCP_URL=https://frigologmcp.vercel.app/api/mcp npm test   # valider le contrat live

🏗️ Architecture

• Stack : TypeScript + une Vercel Function (api/mcp.ts).
• Transport : HTTP POST, JSON-RPC 2.0 (initialize, tools/*, resources/*, prompts/*).
• Données : statiques dans lib/data/*.ts ; versionnées/sourcées via data/regulatory-version.json + lib/data/sources.ts. Deux tools temps réel (RappelConso, Alim'confiance).
• Sans base de données, sans auth.

Licence

MIT — voir LICENSE. Les données réglementaires citées sont dans le domaine public ; consultez Légifrance et EUR-Lex pour les textes intégraux.

_Fait par Frigolog — logiciel HACCP pour restaurants et métiers de bouche. frigolog.fr_