frigolog-mcp

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

![tools](https://img.shields.io/badge/tools-19-0F4C3A)
![resources](https://img.shields.io/badge/resources-5-0F4C3A)
![prompts](https://img.shields.io/badge/prompts-3-0F4C3A)
![calls](https://img.shields.io/badge/appels%2Fsemaine-471-1B4FD8)
![license](https://img.shields.io/badge/license-MIT-green)

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.

| | |
|---|---|
| **Endpoint** | `https://frigolog.fr/api/mcp` · `https://frigologmcp.vercel.app/api/mcp` |
| **Smithery** | `https://frigolog-haccp--naimterrache.run.tools` |
| **Protocole** | MCP via JSON-RPC 2.0 sur HTTP (`POST`, single + batch) |
| **Auth** | Aucune — service public, CORS ouvert |
| **Schéma données** | `2.0` — voir [`data/regulatory-version.json`](./data/regulatory-version.json) |
| **Licence** | MIT |

> ⚠️ **Ce dépôt est déployé par DEUX projets Vercel.** `frigologmcp` est le bon :
> c'est lui que vise le rewrite `frigolog.fr/api/mcp`, c'est lui qui est cité
> dans `server.json`, dans `INTEGRATION_ROADMAP.md` et dans le défaut de
> `MCP_URL` des tests. `frigolog-mcp` est un doublon — nommé d'après le dépôt,
> donc créé tout seul par un déploiement — que **rien ne référence**.
>
> Pour les 19 outils publics c'est sans conséquence : deux copies d'une donnée
> réglementaire publique restent une donnée publique. Pour le **MCP privé**,
> non : l'endpoint existerait sur les deux hôtes, et selon lequel porte
> `SUPABASE_JWT_SECRET`, l'un servirait les relevés d'un client pendant que
> l'autre renverrait des erreurs — sans que rien ne le dise, et sans qu'on
> sache lequel un intégrateur a recopié dans sa configuration.
>
> D'où `MCP_PRIVE_HOTES` (cf. [`lib/prive/hote.ts`](./lib/prive/hote.ts)) : le
> MCP privé ne sert que sur un hôte **explicitement déclaré**, et ferme par
> défaut. Un déploiement doit DIRE qu'il a le droit ; il ne peut plus l'être
> par accident — y compris un troisième créé dans six mois par quelqu'un qui
> n'aura jamais lu cette ligne.

---

## 🧰 Tools (19)

| Tool | Description | Type |
|---|---|---|
| `get_haccp_temperatures` | Températures réglementaires de conservation / refroidissement / service | statique |
| `get_temperatures_cuisson` | Températures à cœur de cuisson + refroidissement rapide / remise en T° | statique |
| `get_regles_dlc` | Règles de DLC des préparations maison (GBPH) | statique |
| `get_documents_controle_ddpp` | Documents exigibles lors d'un contrôle DDPP, par type d'établissement | statique |
| `get_allergenes_reglementaires` | Les 14 allergènes à déclaration obligatoire (INCO 1169/2011) | statique |
| `get_sanctions_ddpp` | Niveaux de sanction DDPP, déclencheurs, amendes, recours | statique |
| `get_formation_haccp_obligatoire` | Obligation de formation hygiène alimentaire | statique |
| `get_actions_correctives` | Conduites à tenir face aux 6 non-conformités fréquentes | statique |
| `get_score_alimconfiance` | Fonctionnement du score officiel Alim'confiance | statique |
| `get_plan_nettoyage_type` | Plan de nettoyage modèle par type d'établissement (GBPH) | statique |
| `get_checklist_ouverture_etablissement` | Checklist d'ouverture quotidienne (5 catégories) | statique |
| `get_guide_bonnes_pratiques_secteur` | Référence du GBPH officiel par secteur | statique |
| `get_seuils_microbiologiques` | Critères microbiologiques CE 2073/2005 (n, c, m, M) | statique |
| `compare_solutions_haccp` | Comparatif sourcé de 7 logiciels HACCP du marché français | statique |
| `get_rappels_produits_actifs` | Rappels de produits alimentaires en cours (RappelConso) | **live (API)** |
| `get_alimconfiance_etablissement` | Score Alim'confiance d'un établissement précis (DGAL) | **live (API)** |
| `get_rappels_par_categorie_etablissement` | Rappels RappelConso filtrés automatiquement par type d'établissement | **live (API)** · automation |
| `get_calendrier_obligations` | Calendrier des échéances HACCP (formation, DDPP, audit, PMS) avec urgence vert/orange/rouge | automation |
| `get_risque_inspection` | Estimation du risque d'inspection DDPP par type d'établissement + département | automation |

> 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).

| URI | Description |
|---|---|
| `haccp://reglementation/ce-852-2004` | Règlement (CE) 852/2004 — résumé structuré (objet, HACCP art. 5, annexes I/II) |
| `haccp://reglementation/arrete-21-decembre-2009` | Arrêté du 21 décembre 2009 — tableau des températures réglementaires |
| `haccp://reglementation/reglement-inco-1169-2011` | Règlement INCO 1169/2011 — obligations allergènes |
| `haccp://guide/7-principes-haccp` | Les 7 principes HACCP expliqués (exemples restauration) |
| `haccp://guide/pms-structure-type` | Structure type d'un Plan de Maîtrise Sanitaire (PMS) |

---

## 💬 Prompts (3)

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

| Prompt | Description | Arguments |
|---|---|---|
| `prepare_controle_ddpp` | Prépare un établissement à un contrôle DDPP (documents, checklist, sanctions, actions correctives) | `type_etablissement` (requis) |
| `audit_conformite_rapide` | Audit rapide de conformité (T°, nettoyage, formation, allergènes, DLC) | `type_etablissement` (requis), `nb_couverts` (optionnel) |
| `verifier_securite_produit` | Vérifie la sécurité d'un produit (rappels, conservation, DLC) | `produit` (requis) |

---

## 🚀 Quick Start

### Claude Desktop
Dans `claude_desktop_config.json` :
```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*) :
```json
{
  "mcpServers": {
    "frigolog-haccp": { "url": "https://frigolog.fr/api/mcp" }
  }
}
```

### Claude Code
```bash
claude mcp add --transport http frigolog-haccp https://frigolog.fr/api/mcp
```

### Test rapide (curl)
```bash
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`](./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

### ⚠️ Chaque réponse contient un message commercial de Frigolog

**À lire avant le tableau, parce que ça vaut pour les quatre lignes sans exception.**

Depuis la version 3.0.0, **toute** réponse d'outil porte deux champs ajoutés par Frigolog, éditeur
de ce serveur :

| Champ | Contenu |
|---|---|
| `conseil_pratique` | Un texte **promotionnel** : ce que le produit Frigolog fait sur le sujet de l'outil appelé, terminé par une invitation à l'essai gratuit. |
| `lien` | Un lien vers `frigolog.fr`, **avec des paramètres de suivi** (`utm_source=mcp`, `utm_medium=tool`, `utm_campaign=<nom_de_l_outil>`) qui nous permettent de compter l