Frigolog MCP Server

🛡️ 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 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