关于 Recap
Recap 是通过 RECAP 档案查找美国联邦法院案件文件链接的 MCP 服务,适用于调查案件提交材料。档案覆盖不完整,结果提供 PDF 链接而非提取文本。
主要功能
- 01按 docket ID 或法院与案号查找材料
- 02返回 PDF 链接和 docket 条目编号
- 03提供附件编号和文件大小
- 04在可用时返回 docket 清单
- 05无需 API 密钥
适用场景
- 01查找起诉书、动议、裁定或证物
- 02检查联邦案件中可获取的提交材料
- 03打开文件链接以审阅 PDF
MCP 相关
向 MCP 客户端提供 `recap_filings` 工具,按 docket 返回可用的 RECAP 文件链接和提交材料元数据。可通过本地 stdio 或 Pipeworx 网关运行。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/recap/mcpclaude mcp add --transport http pipeworx-io-recap https://gateway.pipeworx.io/recap/mcp{"mcpServers":{"pipeworx-io-recap":{"type":"http","url":"https://gateway.pipeworx.io/recap/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-recap":{"type":"http","url":"https://gateway.pipeworx.io/recap/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-recap":{"type":"http","url":"https://gateway.pipeworx.io/recap/mcp"}}}{"mcpServers":{"pipeworx-io-recap":{"serverUrl":"https://gateway.pipeworx.io/recap/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
RECAP — 美国联邦法院案件中提交的文件
直接链接到联邦案件中提交的起诉书、动议、命令和证据。无需 API 密钥,也无需支付 PACER 费用。
属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。
身份验证
无。
无需密钥即可实现的原理
RECAP 文档不包含在 CourtListener 的批量导出数据中。它们被镜像到 Internet Archive,且其标识符可以推导出来:
gov.uscourts.<court_id>.<pacer_case_id>
联邦案卷覆盖范围中,100% 的案卷都带有 court_id,84.8% 带有 pacer_case_id,因此可以计算出案件文件的地址。无需与任何人达成协议,也无需按页付费。
你能获取什么,不能获取什么
**你能获取:**每份 PDF 的链接、其案卷条目编号和附件编号、文件大小,以及存在时的案卷清单。
**你获取不到文本。**对 400 份案卷进行的测量显示:141 个存档项目包含 PDF,没有一个包含提取出的文本。要阅读文件,必须打开文档。要让这些文件可搜索,需要开展 OCR 项目;本工具并非此类项目。
覆盖范围不完整且分布不均
RECAP 收录的是 PACER 用户付费获取并贡献的内容,因此覆盖范围取决于律师的使用情况。对 16 个法院的 400 份案卷进行测量后,结果如下:
| 法院 | 法院 | ||
|---|---|---|---|
cafc 联邦巡回上诉法院 | 76% | cacd 加利福尼亚中区 | 20% |
ca2 第二巡回上诉法院 | 68% | cand 加利福尼亚北区 | 16% |
paed 宾夕法尼亚东区 | 60% | txsd 得克萨斯南区 | 12% |
ca9 第九巡回上诉法院 | 56% | ilnd 伊利诺伊北区 | 12% |
nysd / dcd | 48% | cacb 加利福尼亚中区破产法院 | 8% |
总体:35.8%。
其影响比数字本身更重要:**“没有文档”意味着没有人向 RECAP 贡献文档,而不是没有提交任何文件。**大约三分之二的案件会返回空结果,而且每个响应都会说明这一点。大多数情况下,把空结果当作法院记录的事实是错误的。
工具
recap_filings — 提供任意案卷搜索结果中的 docket_id,或提供 court 和 docket_number。
recap_filings({docket_id: 73433096})
→ V.O.S. Selections, Inc. v. Trump (cafc), 18 documents
文件名编码了结构:….12.0.pdf 是案卷条目 12,….12.1.pdf 是其第一个附件。这种排序是存档中唯一提供的结构——没有文档标题——因此会在结果中返回,而不会隐藏。
相关工具
federal_civil_search、federal_criminal_search、federal_appeal_search、bankruptcy_search— 首先查找案卷court-listener— 判决意见和完整案件文本,属于完全不同的数据集
数据来源
- https://archive.org/ — RECAP 存档项目
- 联邦案卷覆盖数据(CourtListener 批量数据,公共领域标记)
RECAP 的存在归功于 Free Law Project 的建设和 PACER 用户的贡献:https://free.law/donate/
快速开始
将其添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"recap": {
"url": "https://gateway.pipeworx.io/recap/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/recap/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/recap_filings \
-H 'Content-Type: application/json' \
-d '{"docket_id":73433096}'
首次调用无需账户。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/recap_filings。查找工具:使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。
独立运行(无需网关账户)
此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户,也无需经过网关往返:
{
"mcpServers": {
"recap": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-recap"]
}
}
}
或者直接运行,以确认服务能够启动:
npx -y @pipeworx/mcp-recap
它通过 stdin/stdout 使用 MCP,并且仅针对此工具包中的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的共享元工具。来源相同,工具相同,但没有 ask_pipeworx 路由功能。
使用 ask_pipeworx
你可以用通俗的英语提问,而不必直接调用工具——此功能既适用于上面的工具包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Recap data" })
网关会选择合适的工具并自动填充参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。