Fda Inspections

fda-inspections

来自 FDA Data Dashboard（Office of Inspections and Investigations）的 FDA 检查结果、Form 483 引用、合规行动和进口拒绝记录。

属于 Pipeworx 的一部分 — 一个将 AI Agent 连接到 1679+ 个实时数据源的 MCP 网关。

这不是 openFDA。 openFDA 提供药品／器械不良事件、标签、召回和警告信数据。它不提供检查分类、483 观察结果或边境拒绝记录——这些数据仅存在于 OII 自己的 Data Dashboard 中，使用不同的主机和不同的凭据。

工具

工具	可解答的问题
fda_inspections	该场所是否接受过检查，结果如何（NAI / VAI / OAI）？
fda_483_citations	为何被引用——涉及哪条 CFR 条款，调查员写了什么？
fda_compliance_actions	后续采取了哪些执法行动——警告信、禁令、扣押还是取消资格？
fda_import_refusals	哪些货物在边境遭到拒绝，理由是什么？
fda_firm_risk_profile	一次性查询某个制造商的以上全部四项，并解析其 FEI 场所。

身份验证

凭据是一对，而非单个密钥：

Authorization-User: <the e-mail it was issued to>
Authorization-Key:  <the FDA-generated key>

以合并形式 "email:key" 作为 _apiKey 传入（按第一个冒号拆分）。平台密钥：PLATFORM_FDA_DASHBOARD_KEY，使用相同的合并形式，并设置在网关和 registry-api 工作进程上。

凭据免费：在 OII Unified Logon 应用中创建账户 https://www.accessdata.fda.gov/scripts/oul，然后申请 Data Dashboard API 访问权限。FDA 会将密钥发送到你注册的邮箱地址，该地址也会成为 Authorization-User 的值。平台凭据已经设置好，因此调用方无需自己的密钥。

请注意，datadashboard.fda.gov 会向默认的 curl User-Agent 返回 403——手动查阅文档时请发送浏览器 UA。API 主机（api-datadashboard.fda.gov）没有此限制。

请求约定

已通过实际端点验证，而非依赖假设——格式错误的请求体会返回 400 并指出有问题的字段，格式正确但未通过身份验证的请求体会返回 401，因此无需凭据即可测试请求格式。

• POST https://api-datadashboard.fda.gov/v1/<resource>
• 请求体：{ start, rows, sort, sortorder, columns[], filters{} }
• sort 和 sortorder 是必填项，并非可选项。
• start 从 1 开始计数。
• rows 最大为 5000。
• columns 是必填项——省略后会返回 400 并指出缺少的字段。
• 筛选值必须是数组——{"State": ["California"]}。直接使用字符串会返回 400。
• 日期范围使用带后缀的键：InspectionEndDateFrom / InspectionEndDateTo。没有顶层日期范围参数，且不带后缀的日期字段名会被拒绝为筛选键。
• 大多数字符串筛选都按 LIKE %term% 进行不区分大小写的匹配，因此企业名称会进行子字符串搜索。State 是例外——见下文。

注意：State 是精确匹配，填错后看起来就像“从未接受过检查”

LegalName、FirmName 和 CountryName 会进行不区分大小写的子字符串匹配。State 必须与拼写完整的名称精确匹配，且区分大小写。"CA"、"Ca" 和 "CALIFORNIA" 都会返回正常的 200，但 resultcount: 0——这会让人以为该场所从未接受过检查，而不是传入的参数有误。只有 "California" 会返回数据。

该工具包会规范化邮政编码和大小写（normalizeState），因此调用方可以传入任一形式。外国企业的 State: null；请改用 country 筛选这些企业。

注意：企业搜索使用子字符串匹配，因此匹配范围可能过宽

firm: "Intas" 也会匹配 Cintas Corporation。fda_firm_risk_profile 会在 matched_establishments 中返回所有匹配到的 FEI，方便你检查——引用汇总计数前，请先查看该列表，因为计数是根据所有匹配行计算的。

注意：名称列并不统一

import_refusals 使用 FirmName。另外三个资源使用 LegalName。如果传错字段，会因字段名无效而被拒绝，因此该工具包按资源指定名称列，而不是假定所有资源都相同。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/fda-inspections/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 都连接到同一个网关和同样的 1679+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪个端点，ask_pipeworx 都可以访问所有工具包。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/fda_inspections \
  -H 'Content-Type: application/json' \
  -d '{"firm":"Intas","limit":25}'

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

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

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

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

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-fda-inspections

它通过 stdin/stdout 使用 MCP，并且对 initialize/tools/list/tools/call 的响应仅包含此工具包的工具——不包含上述网关连接额外提供的任何共享元工具。源代码相同，工具相同，不提供 ask_pipeworx 路由。

与 ask_pipeworx 配合使用

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

ask_pipeworx({ question: "your question about Fda Inspections data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT