Frigolog HACCP

🛡️ Frigolog HACCP MCP — 法国食品合规参考 MCP 服务

19 个工具 · 5 个资源 · 3 个提示词 · 监管数据 + RappelConso 和 Alim'confiance 实时 API

公开的 Model Context Protocol 服务，向 AI Agent（Claude、ChatGPT、Perplexity、自定义 Agent）提供法国 HACCP 数据，使其能够就食品安全给出准确且附有来源的回答，而不是编造监管规定，让经营场所在检查时陷入风险。

每个回答都包含 type 字段（官方 / 指南 / 对比 / 实时）、准确的 sources 链接（Légifrance、EUR-Lex、DGAL、DGCCRF）以及核验日期。

端点	https://frigolog.fr/api/mcp · https://frigologmcp.vercel.app/api/mcp
Smithery	https://frigolog-haccp--naimterrache.run.tools
协议	通过 HTTP 使用 MCP 和 JSON-RPC 2.0（POST，支持单个请求和批量请求）
身份验证	无 — 公开服务，开放 CORS
数据架构	2.0 — 参见 data/regulatory-version.json
许可证	MIT

⚠️ 此仓库由两个 Vercel 项目部署。 frigologmcp 才是正确的项目： frigolog.fr/api/mcp 的 rewrite 指向它，server.json 中引用的也是它， 测试中的 MCP_URL 默认值同样指向它。frigolog-mcp 是一个重复项目—— 它以仓库命名，因此在部署时自动创建——没有任何引用指向它。

对于 19 个公开工具，这不会造成影响：同一份公开监管数据有两个副本， 仍然是公开数据。但对于私有 MCP，情况就不同了：两个主机上都会有该端点， 而根据哪个主机配置了 SUPABASE_JWT_SECRET，一个会提供某个客户的记录， 另一个则会返回错误——既没有任何提示，也无法知道集成方把哪个主机复制到了配置中。

因此设置了 MCP_PRIVE_HOTES（参见 lib/prive/hote.ts）： 私有 MCP 只会在明确声明的主机上提供服务，默认关闭。部署必须明确声明 自己有权限；这样就不会再有意外开放的情况——包括六个月后由从未读过此说明的人创建的第三个部署。

---

🧰 工具（19）

工具	描述	类型
get_haccp_temperatures	法规规定的储存／冷却／供餐温度	静态
get_temperatures_cuisson	烹饪中心温度 + 快速冷却／重新加热温度	静态
get_regles_dlc	家庭自制食品的保质期限（DLC）规则（GBPH）	静态
get_documents_controle_ddpp	DDPP 检查时按机构类型要求提供的文件	静态
get_allergenes_reglementaires	必须申报的 14 种过敏原（INCO 1169/2011）	静态
get_sanctions_ddpp	DDPP 的处罚等级、触发条件、罚款及申诉途径	静态
get_formation_haccp_obligatoire	食品卫生培训要求	静态
get_actions_correctives	面对 6 种常见不合规情况时应采取的措施	静态
get_score_alimconfiance	官方 Alim'confiance 评分的运作方式	静态
get_plan_nettoyage_type	按机构类型制定的清洁计划模板（GBPH）	静态
get_checklist_ouverture_etablissement	每日开业检查清单（5 个类别）	静态
get_guide_bonnes_pratiques_secteur	各行业官方 GBPH 指南参考	静态
get_seuils_microbiologiques	CE 2073/2005 微生物标准（n、c、m、M）	静态
compare_solutions_haccp	法国市场上 7 款 HACCP 软件的资料来源对比	静态
get_rappels_produits_actifs	当前食品召回信息（RappelConso）	实时（API）
get_alimconfiance_etablissement	特定机构的 Alim'confiance 评分（DGAL）	实时（API）
get_rappels_par_categorie_etablissement	按机构类型自动筛选的 RappelConso 召回信息	实时（API） · 自动化
get_calendrier_obligations	HACCP 期限日历（培训、DDPP、审核、PMS），并以绿色／橙色／红色标示紧急程度	自动化
get_risque_inspection	按机构类型 + 省份估算 DDPP 检查风险	自动化

每条描述均为双语：法语正文 + [EN] 摘要。 最后 3 个工具已可用于自动化：AI Agent 可定期调用它们（每天早晨／每周／每季度），以监控机构状况。

---

📚 资源（5）

使用 resources/list，然后使用 resources/read，即可阅读结构化参考文本（Markdown 格式，附有资料来源的教学摘要——非全文）。

URI	描述
haccp://reglementation/ce-852-2004	(CE) 852/2004 条例——结构化摘要（目的、HACCP 第 5 条、附件 I/II）
haccp://reglementation/arrete-21-decembre-2009	2009 年 12 月 21 日法令——法规温度表
haccp://reglementation/reglement-inco-1169-2011	INCO 1169/2011 条例——过敏原相关义务
haccp://guide/7-principes-haccp	详解 HACCP 的 7 项原则（餐饮示例）
haccp://guide/pms-structure-type	卫生控制计划（PMS）的标准结构

---

💬 提示词（3）

使用 prompts/list，然后使用 prompts/get，即可获取可直接使用、按顺序调用工具的工作流。

提示词	描述	参数
prepare_controle_ddpp	为机构准备 DDPP 检查（文件、检查清单、处罚、纠正措施）	type_etablissement（必填）
audit_conformite_rapide	快速合规审核（温度、清洁、培训、过敏原、DLC）	type_etablissement（必填），nb_couverts（可选）
verifier_securite_produit	检查产品安全性（召回、储存、DLC）	produit（必填）

---

🚀 快速开始

Claude Desktop

在 claude_desktop_config.json 中：

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

仅支持 stdio 客户端："command": "npx", "args": ["-y", "mcp-remote", "https://frigolog.fr/api/mcp"]。

Cursor

在 ~/.cursor/mcp.json 中（或前往 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

快速测试（curl）

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

---

🗣️ 示例（Agent ↔ MCP）

1. 准备 DDPP 检查

用户：“我下周要在餐厅接受 DDPP 检查，帮我做好准备。” **Agent：**获取提示词 prepare_controle_ddpp(type_etablissement="restaurant")，调用 get_documents_controle_ddpp、get_checklist_ouverture_etablissement、get_sanctions_ddpp、get_actions_correctives，然后提供一份优先级计划（需要准备的文件、关键事项、处罚风险），并附上 Légifrance/EUR-Lex 参考资料。

2. 了解法规规定的温度

用户：“新鲜鱼类应在什么温度下保存？” **Agent：**调用 get_haccp_temperatures(categorie="poisson") →“0 至 +2 °C，置于融冰上”（法规 (EC) 853/2004），并附上 EUR-Lex 链接。

3. 实时查询产品召回

用户：“我库存里的烟熏三文鱼是否正在召回？” **Agent：**调用 get_rappels_produits_actifs(categorie="poisson")（RappelConso 实时数据）→列出正在进行的召回及应采取的措施，并附上官方信息页链接。

---

🗂️ 数据 — 官方来源

所有法规数据均在 data/regulatory-version.json 中标明来源并注明版本（准确链接 + 每项法规文本的核验日期）。欧盟法规链接至 EUR-Lex，法国法规文本链接至 Légifrance。

• Journal officiel / Légifrance — 2009 年 12 月 21 日法令、《农村法典》、培训、许可和食用油相关法令及条例。
• EUR-Lex — 法规 (EC) 852/2004、853/2004、178/2002、2073/2005、1441/2007、(EU) 1169/2011、1379/2013、2024/2895。
• DGAL — 农业部 — 良好卫生规范指南（GBPH）、Alim'confiance 数据集（dgal.opendatasoft.com）。
• DGCCRF — data.economie.gouv.fr / data.gouv.fr — RappelConso（产品召回，实时）。
• Alim'confiance — www.alim-confiance.gouv.fr（官方卫生检查结果）。

对于无法确切确认的数值（某些 GBPH、部分微生物标准），会明确标注“需核实”，而不会凭空编造。

---

🔍 编辑透明度

⚠️ 每条回复都包含 Frigolog 的商业信息

请先阅读以下内容，再查看表格，因为这适用于表格中的四行，无一例外。

自 3.0.0 版本起，工具的每条回复都包含 Frigolog（此服务的发布方）添加的两个字段：

字段	内容
conseil_pratique	推广性文本：介绍 Frigolog 产品在所调用工具相关主题上的功能，结尾附有免费试用邀请。
lien	指向 frigolog.fr 的链接，附带跟踪参数（utm_source=mcp、utm_medium=tool、utm_campaign=<nom_de_l_outil>），用于统计通过此服务产生的访问量。

这两个字段并非法规数据，也不受回复中任何 sources 的支持。它们是附加在有来源支持的内容旁边，而非取代后者：法规内容本身保持完整，且可通过其 sources 核实。

**如果您复用或改写此服务的回复，这两个字段表达的是我们的观点，而非官方文本的观点。**它们被单独放在名称明确的字段中，方便您忽略、注明其来自 Frigolog，或进行过滤。

type 字段的含义

type 字段描述的是 data 字段的内容——也就是除上述两个商业字段之外的所有内容：

type	含义	Frigolog 在 data 中的作用
reglementaire_officiel	法律文本、法令、欧盟法规、法典	无——有来源的原文
guide_pratique	良好实践（DGAL GBPH + 一线经验）	编辑性总结，并关联法规依据
comparatif_commercial	HACCP 软件对比	利益冲突：Frigolog 既是 MCP 的开发者，也是被比较的一方
donnee_temps_reel	国家开放数据（RappelConso、Alim'confiance）	无——实时代理

换句话说：reglementaire_officiel 响应中包含中立且有来源的 data，以及推广 Frigolog 的 conseil_pratique。两者以不同名称共存于同一个 JSON 对象中。

compare_solutions_haccp：每个解决方案都附有公开的 sources；若价格未公开显示，则会如实填写 note_verification；avertissement 会说明利益冲突。对于竞争对手，mentions_site_public 汇报其公开网站截至 site_consulte_le 日期提及的内容——这并不代表其产品具备相应功能。

---

🧪 版本管理与测试

• 版本管理：data/regulatory-version.json（模式 2.0）是唯一信息源——包含版本、官方链接、核验日期，每 6 个月修订一次。
• 测试：npm test（零依赖，Node ≥ 20）——版本文件结构、来源解析、URL 存活状态（403/429 = 可访问但受到保护）、工具实时契约，以及 19 个工具 / 5 个资源 / 3 个提示词的计数。
• 构建：npm run build（tsc --noEmit）。

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

---

🏗️ 架构

• 技术栈：TypeScript + 一个 Vercel Function（api/mcp.ts）。
• 传输方式：HTTP POST，JSON-RPC 2.0（initialize、tools/*、resources/*、prompts/*）。
• 数据：静态存储于 lib/data/*.ts；通过 data/regulatory-version.json + lib/data/sources.ts 进行版本管理和来源标注。两个实时工具（RappelConso、Alim'confiance）。
• 无数据库，无身份验证。

---

许可证

MIT——请参阅 LICENSE。所引用的法规数据属于公共领域；完整文本请查阅 Légifrance 和 EUR-Lex。

---

由 Frigolog 打造——为餐厅和食品行业提供的 HACCP 软件。frigolog.fr