Scotcourts

@pipeworx/scotcourts

苏格兰法院和法庭判决检索——苏格兰高等民事法院、最高刑事法院、国家人身伤害法院、郡长上诉法院、郡长法院民事／刑事案件，以及苏格兰上级法庭各分庭；数据来自苏格兰法院与法庭服务局（SCTS），收录 1999 年以来发布的判决。

Pipeworx 的一部分：Pipeworx 是一个 MCP 网关，可将 AI Agent 连接到 1683+ 个实时数据源。

工具

• search_scottish_judgments(query?, court?, from_date?, to_date?, page?, limit?) — 搜索判决索引；返回标题、法院、法官、日期和指向 PDF 的 document_link，以及语料库的实际匹配总数。
• get_scottish_judgment(document_link?, query?) — 解析判决的 document_link（或先按案件名称／查询词查找），并确认 PDF 确实可访问：HTTP 状态、内容类型、大小。不会 提取 PDF 文本——SCTS 判决仅提供 PDF，本目录中没有任何 PDF 文本提取 依赖；始终会在 pdf_url 旁返回 text_extracted: false。

身份验证

无需密钥。无需 API 密钥、Cookie 或 bearer token——已通过普通 curl（无浏览器会话）对 api.pa.web.scotcourts.gov.uk/web/search 进行实时验证。

数据源

• https://api.pa.web.scotcourts.gov.uk/web/search（POST，JSON）——客户端渲染的 SPA 背后的判决搜索索引，SPA 位于 scotcourts.gov.uk/judgments/#/。请勿使用 scotcourts.gov.uk/search-results/?filterType=Judgments——这是 全站通用搜索（服务器渲染的 HTML），会将新闻文章和庭审／直播页面与真实判决混在一起；在本工具包的调查中已将其判定为 无效路径（fleet #2259）。
• https://www.scotcourts.gov.uk<documentLink> — 判决 PDF 本身。 API 响应中的 documentLink 是相对路径；需将其与此主机名拼接解析。

构建过程中发现的陷阱（fleet #2259 spike，#2262 build）

• 判决 SPA 和全站搜索是两个完全独立的应用，运行于 两个不同的主机名上。从 /judgments/ 引用的静态 bundle （/apps/scts-web-apps.min.js）只是全站共享的界面框架，不包含判决应用本身的逻辑——判决应用会在 运行时动态加载，因此请求格式是通过 devtools 和 monkey-patch window.fetch 驱动实时页面捕获的，而不是通过阅读静态 bundle 得出的。
• filters 的结构（已在浏览器内和直接使用 curl 实时验证）：
  • 法院：{"field":"Court","value":"<exact dropdown string>"} — 不能根据法院的常用名称来猜测 值（例如，下拉菜单中显示的是 "Court of Session"，而不是 "Court of Session (Outer House)"）。完整列表位于 src/index.ts 中的 COURTS。
  • 日期范围：{"field":"AdditionalDate","value":"<from>|<to>"} — 管道符任意一侧都可以留空，以表示开放范围（"2020-01-01|" = 仅起始日期，"|2020-01-01" = 仅结束日期）。两种格式均已实时验证。
  • 无法识别的 Court 值不会报错——它会返回 HTTP 200，且 results: [] 和 pagination.count.total: 0；若未发现这一点，看起来就会像是“没有此类判决”。本工具包会在发送筛选条件前，根据已知列表 验证 court。
  • 四个基本字段（关键词、法院、起始日期、结束日期）背后的“显示更多筛选条件”面板 未进行逆向工程——不在本次构建的范围内；仅发布已验证的功能。
• pagination.count.total 是语料库的实际匹配总数；results.length 受请求中 limit 的限制。应将 total 而非 results.length 显示为“匹配的判决数量”。
• 覆盖范围说明：此索引仅包含 SCTS 选择发布的内容，涵盖 1999 年以来的判决——并非所有曾经作出的苏格兰判决。与高级法院相比，郡长法院和法庭的收录较少。这是苏格兰法律；英格兰和威尔士／英国最高法院／英国法庭的裁决属于另一个语料库（@pipeworx/uk-caselaw）。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/scotcourts/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_scottish_judgments \
  -H 'Content-Type: application/json' \
  -d '{"query":"negligence"}'

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

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

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

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

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

npx -y @pipeworx/mcp-scotcourts

它通过 stdin/stdout 使用 MCP 协议，并为仅属于此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接所提供的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Scotcourts data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT