Aphis Animal Care

@pipeworx/aphis-animal-care

《动物福利法》（AWA）许可持有人和注册人，包括商业犬只繁育者、经销商、展览方、运输方和研究机构，以及 APHIS Animal Care 针对他们撰写的检查报告、严重／直接违规次数和官方签署报告 PDF 链接。

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

工具

• aphis_licensee_search(state?, license_type?, name?, city?, zip?, certificate_number?, customer_number?, kind?, status?, limit?, page?) — 查询谁持有 AWA 许可证或注册。可回答“密苏里州获得 USDA 许可的犬只繁育者有哪些”“查询证书 43-A-6814”“这家犬舍是否获得 USDA 许可”等问题。返回名称、证书编号、许可类别、证书状态（有效／已取消／已撤销）以及设施所在城市、县和 ZIP。
• aphis_inspection_reports(state?, license_type?, name?, city?, zip?, certificate_number?, customer_number?, animal_category?, citation?, teachable_moments_only?, limit?, page?) — Animal Care 检查报告，包含检查日期、许可持有人、地点、严重／直接／非严重违规次数、可借鉴案例，以及 report_pdf_url（官方签署的报告）。
• aphis_inspection_filter_options(query?, kind?, limit?) — 检查筛选器支持的 34 种动物类别和 2,165 个 AWA 引用条款代码。

身份验证

无需密钥。无需账户、Cookie 或会话令牌。

数据来源

• https://efile.aphis.usda.gov/PublicSearchTool/s/sfsites/aura — USDA APHIS eFile 公共搜索工具背后的 Aura 端点。使用的操作： apex://EFL_PSTController/ACTION$doCustomerQuery（许可持有人／注册人）、 …$doIRSearch_UI（检查报告）、…$getSearchSetup（州和许可类型词汇表）、…$getIRSearchFilters（动物类别、引用条款代码）。

下一位使用者本可能要费一番功夫才能重新发现的事项

这项数据没有公开的 REST API 文档，也没有密钥。Public Search Tool 是一个 Salesforce Lightning 社区；其搜索通过 Aura 端点运行。我们通过 CDP 驱动无头 Chrome 执行一次真实搜索，并从网络请求中读取 Apex 类和方法——盲猜 Apex 类名行不通，因为错误的类名和错误的方法会返回字节完全相同的 No apex action available for X.y。

• “不允许访客用户访问”并非策略限制。 格式错误或缺失的 aura.context 会返回该消息，描述符为 aura:invalidSession，看起来像是硬性拒绝匿名调用者。 其实不是——访客可以访问该端点。经 2026-09-05 测试，aura.context 只需包含 {"mode":"PROD","app":"siteforce:communityApp"} 即可。
• fwuid 无关紧要。 虚假的 fwuid 和省略 fwuid 都会返回 SUCCESS。因此，本工具包不会从页面抓取框架版本，也不会因 Salesforce 更新版本而失效。
• index 是页码，不是行偏移量，而上游会将底层 SOQL 偏移量限制为 2,000 行：page * page_size <= 2000。超过后会抛出 Maximum SOQL offset allowed for apiName EFLLicense__c is 2000。 totalCount 仍是未分页的真实总数（仅密苏里州就有 4,986 个 A 类繁育者许可证），因此应缩小范围，而不是分页。
• irFilterCriteria 的键必须是单数形式。 animalCategory 和 sectionCode 各接受一个 Salesforce ID。复数形式 animalCategories: [id] 会被静默忽略，并以 200 状态码返回未筛选的计数——这是静默的错误答案，而不是错误提示。
• 检查搜索不支持日期筛选。 inspectionDateFrom、fromDate 和 startDate 都会被忽略。请在调用方按 inspection_date 筛选。
• 许可证记录不等于企业。 同一人会因每张证书出现一次，而且任何州的大多数记录都是已取消的历史许可证。要查询“目前持证者”，关键参数是 status: "active"。
• sObjectType 用于选择登记册：EFLLicense__c（A/B/C 类持证者）与 EFLRegistration__c（注册者——研究机构、承运商、中间处理者）。

快速开始

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

{
  "mcpServers": {
    "aphis-animal-care": {
      "url": "https://gateway.pipeworx.io/aphis-animal-care/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/aphis-animal-care/mcp 上的 tools/list 会返回上表中的工具，以及共享的 Pipeworx 元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 以及整个网关通用的其他工具。因此，你看到的工具数量会多于此表所列：单个工具包端点目前除了工具包自身的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是判断特定日期可用内容的权威依据。

这是有意为之，并非意外的多路复用。元工具可以让作用域受限的连接回答本工具包未涵盖的问题——通过 ask_pipeworx 路由到整个目录——而无需你再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的 schema 占用的上下文超过了路由功能的价值，请直接连接完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是当前工具包的工具：

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

两个 URL 都会连接到同一个网关和相同的 1872+ 个数据源。唯一的区别是直接列出的工具属于哪个工具包；无论连接哪一个，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/aphis_licensee_search \
  -H 'Content-Type: application/json' \
  -d '{"state":"Missouri","license_type":"BREEDER","status":"active","limit":5}'

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

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

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

{
  "mcpServers": {
    "aphis-animal-care": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-aphis-animal-care"]
    }
  }
}

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

npx -y @pipeworx/mcp-aphis-animal-care

它通过 stdin/stdout 使用 MCP 通信，并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Aphis Animal Care data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT