Codex Gsfa

@pipeworx/codex-gsfa

FAO/WHO 食品添加剂通用标准（GSFA，CXS 192-1995）——规定哪些食品可以使用哪些食品添加剂、最大使用量是多少，以及适用哪些条件。

属于 Pipeworx — 一个将 AI Agent 连接到 1831+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也未由其发布。

工具

工具	可回答的问题
gsfa_check_use	INS 461 是否允许用于熟鱼，最大使用量是多少？ — 这正是该标准要回答的问题
gsfa_search_additive	将 INS 编号、名称或别名映射到对应的 GSFA 条目
gsfa_additive_provisions	一种添加剂允许用于的所有食品类别
gsfa_food_category_additives	一个食品类别允许使用的所有添加剂
gsfa_search_food_categories	按名称或编号前缀查找 GSFA 类别编号
gsfa_notes	查找对某项规定设定条件的编号注释，或按措辞搜索注释
gsfa_coverage	该数据集包含哪些内容，以及数据的时效性

两类许可

GSFA 以两种结构上不同的方式授予使用许可，每条返回的规定都会说明其来源：

• 表 1 和表 2（provision_table: "table1_2"）——具体的最大使用量，可以是数值（10,000 mg/kg）或 GMP，通常还受编号注释约束。
• 表 3（provision_table: "table3"）——允许在良好生产规范下使用该添加剂，没有数值限量。

对于甲基纤维素，表 1 和表 2 中有 17 条规定，表 3 中有 61 条。将两者混为一谈，要么会凭空捏造标准并未设定的限量，要么会掩盖添加剂实际允许使用的大部分范围。

子类别继承

GSFA 规定适用于指定食品类别及其所有子类别——对 01.4 的规定也适用于 01.4.4。查询会沿编号逐级向上检查，并返回 inherited_from_parent 和 matched_food_category，因为“该食品在此类别下明确允许使用”和“因其父类别而允许使用”是不同的答案。

permitted: false 表示标准中没有相关规定。这与明确禁止并不相同，响应会如实说明，而不会暗示禁用。

注释是答案的一部分

规定经常受到编号注释的限定——“仅用于即饮产品”、“以二氧化硫计”、“以脂肪为基准”——若没有这些注释，最大使用量就不完整。15,377 条规定中有 2,590 条附带注释。

每条规定都会内嵌注释文本（notes: [{id, text}]），而不是只留下一个裸编号，因为只有编号没有文本，调用方可能会读到使用量就此止步。gsfa_notes 可直接查找编号，也可按注释措辞搜索。

注释文本来自每个添加剂页面中注释图标的工具提示，因此与其限定的添加剂具有相同的 Codex 会话。所有 468 个引用的注释编号均可解析。

身份验证

不需要。数据集包含在此工具包中。

数据时效性

每条添加剂结果都包含 cac_session、cac_year 和 snapshot_date。记录来自 GSFA Online 的存档快照，因此个别添加剂的数据可能落后于最新的 Codex 会话——gsfa_coverage 会报告当前包含哪些会话，以及哪些添加剂编号完全无法检索（即其所有存档快照都是 FAO 自身的错误页面）。

使用以下命令重新生成：

node --experimental-strip-types scripts/ingest-gsfa.ts

数据来源

• Codex GSFA Online — https://www.fao.org/gsfaonline/（FAO 在此网站前端设置了由 Cloudflare 管理的验证挑战；我们改为读取 Internet Archive 快照——有关获取途径和数据时效性计划，请参阅 docs/codex-gsfa-plan.md）
• Codex Alimentarius CXS 192-1995 — https://www.fao.org/fao-who-codexalimentarius/codex-texts/dbs/gsfa/en/
• JECFA 规格和评估，GSFA 链接到这些资料以获取毒理学数据 — https://apps.who.int/food-additives-contaminants-jecfa-database/

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "codex-gsfa": {
      "url": "https://gateway.pipeworx.io/codex-gsfa/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/codex-gsfa/mcp 上的 tools/list 会返回上表中的工具，以及共享的 Pipeworx 元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，还有网关范围内的其他工具。因此，你看到的工具数量会多于此表所列：目前，单个工具包端点除了该工具包自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威答案。

这是有意为之，并非意外的多路复用。元工具让作用范围受限的连接也能回答此工具包未覆盖的问题——通过 ask_pipeworx 在整个目录中进行路由——而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构所占上下文超过了路由带来的收益，请连接一次完整网关，而不要连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都指向同一个网关和相同的 1831+ 个数据源。唯一的区别是哪些工具包的工具会被直接列出；无论使用哪个 URL，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/gsfa_check_use \
  -H 'Content-Type: application/json' \
  -d '{"additive":"461","food_category":"14.1.5"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/gsfa_check_use。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需通过网关往返：

{
  "mcpServers": {
    "codex-gsfa": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-codex-gsfa"]
    }
  }
}

或者直接运行，确认它可以启动：

npx -y @pipeworx/mcp-codex-gsfa

它通过 stdin/stdout 进行 MCP 通信，并针对仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接所添加的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以不用直接调用工具，而是用日常语言提问——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Codex Gsfa data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT