Ni Caselaw

@pipeworx/ni-caselaw

北爱尔兰法院和审裁处的司法裁决，实时读取自 judiciaryni.uk — 上诉法院、刑事法院、国王座庭、家庭庭、死因裁判法院、 法官裁决、估价审裁处等。

属于 Pipeworx — 一个 MCP 网关，将 AI Agent 连接到 1683+ 个实时数据源。

工具

• search_ni_decisions(query?, court?, year?, limit?) — 按 关键词、法院代码（例如 "nica"）和/或年份搜索裁决。每条匹配结果会返回标题、中性引证、 法院、日期、法官，以及裁决 PDF 的链接。
• get_ni_decision(slug) — 根据 judiciaryni.uk slug 获取单条裁决（例如 "2026-nica-36"）。返回完整元数据和 pdf_url；text 始终为 null，text_extracted 始终为 false — 详情见下文。

身份验证

无需密钥。无需运营方密钥。

数据源

• https://www.judiciaryni.uk/judicial-decisions — Drupal Views 列表。 于 2026-09-18 实时探测。存在三个真正的服务器端筛选项： /judicial-decisions/date/<year>（也支持 <year>-<month>）、 /judicial-decisions/type/<slug-id> 和 /judicial-decisions/judiciary/<id>， 另有一个关键词框（?query_decisions=<text>）。没有法院筛选项。 某项判决所属的法院只会显示在其中性引证中；对于大多数现代判决，也会显示在其自身 URL slug 中 （/judicial-decisions/2026-nica-36）。因此，search_ni_decisions 的 court 筛选器 是在翻阅列表时于客户端应用的，不会作为查询参数传给上游——要快速缩小罕见法院的搜索范围， 请将其与 year 结合使用，因为每次调用的页面预算有上限（20 页），未提供年份时， 罕见法院可能需要翻阅超过此上限的页面才能找到足够的匹配项（响应中的 truncated／ pages_scanned 字段会说明这一点，不应将其理解为“没有更多判决”）。

  query_decisions 是对整个语料库进行的真正全文搜索，而不是法院筛选器——搜索 "NICA" 会返回 2,822 条结果，因为其他法院对 NICA 案件的引证中也会出现这个字符串。此处提供该功能 仅用于关键词搜索，与网站自己的搜索框相同。

  此网站的 rss.xml 返回 0 个条目——这是实时检查的结果，并非假设，也未使用。

  User-Agent 在此处有一种不同寻常的影响。 包含单词 “Bot” 的 UA 字符串（测试过： "...PipeworxBot/1.0..."）会被此网站的边缘层（Varnish）直接返回 405；而普通的标识性 UA （pipeworx-mcp-ni-caselaw/1.0 (+https://pipeworx.io)，符合该 monorepo 通常采用的模式） 则会正常返回 200。这不是 robots.txt 的问题——这些是没有限制的公开数据，关于 robots 的规则 已有定论——只是一个值得了解的 WAF 特性，以免误以为网站在拦截机器人。

• 文本仅以 PDF 形式提供。 每项判决的全文都是位于 /files/judiciaryni/<yyyy-mm>/<name>.pdf 下的 PDF；网站的 HTML 中从未包含提取后的文本。 此套件不会解析 PDF——此 monorepo 中没有任何 PDF 文本提取辅助工具（已检查 mcps/*、 shared/src），而此处其他访问仅提供 PDF 的司法来源的套件（gao-protests、recap） 也采用相同方式：仅提供元数据和直接链接，text_extracted 保持为 false，不猜测，也不 静默留空。get_ni_decision 始终返回 text: null, text_extracted: false，并会在自身描述 和 note 字段中说明这一点——按照静默零值策略，必须告知调用方文本不可用，不能只留一个空字段 让调用方自行察觉。

• 法院代码在该网站上不是受控词汇表——具体代码取决于中性引证。实时观察到的常见代码有： nica（上诉法院）、nicc（刑事法院）、nikb（王座法庭庭庭，2022 年归并前称为 niqb——较早的判决可能使用任一代码）、nifam（家庭庭）、nicoroner（死因裁判法院）、 nimaster（法官助理的判决）、nivt（估价法庭，其 slug 不带年份前缀，例如 nivt-325）。较早的社会保障／子女抚养专员判决（例如 "C12/25-26(PIP)"）无法归纳为 明确的法院代码——deriveCourt 对这类判决会返回 null，而不会进行猜测；court 筛选器 也不会匹配这些判决（这是正确行为，不是错误）。

快速开始

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

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

此端点实际提供的内容

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/search_ni_decisions \
  -H 'Content-Type: application/json' \
  -d '{"court":"nica","year":2026,"limit":5}'

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

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

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

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

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

npx -y @pipeworx/mcp-ni-caselaw

它通过 stdin/stdout 使用 MCP，并对 initialize/tools/list/tools/call 作出响应，仅提供此工具包的工具——不包含上方网关连接所添加的任何共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Ni Caselaw data" })

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

更多信息

• 文档与指南
• pipeworx.io

许可证

MIT