内容
<p align="center"><img src="./assets/logo.png" alt="rechtspraak-mcp" width="120" height="120"></p>
# 工具列表
[](https://www.npmjs.com/package/rechtspraak-mcp)
[](https://github.com/Prudai/rechtspraak-mcp/actions/workflows/ci.yml)
[](./LICENSE)
一款面向**荷兰案例法**（jurisprudentie / uitspraken）的[模型上下文协议](https://modelcontextprotocol.io)服务器。它封装了官方的 **[荷兰司法开放数据](https://www.rechtspraak.nl/Uitspraken/Paginas/Open-Data.aspx)** API 和 **[LiDO](https://linkeddata.overheid.nl/)** 引用图，使得任何支持MCP的代理（Claude、Cursor等）都可以搜索判决、通过ECLI获取全文，并探索决策之间的引用关系。
无需API密钥。
```bash
npx rechtspraak-mcp
```
## 工具
| 工具 | 功能 |
|------|--------------|
| `search_uitspraken` | 搜索案例法（默认分面搜索；全文搜索需设置标志）。返回ECLI + 链接。 |
| `search_uitspraken_bulk` | 一次运行3-10个搜索。 |
| `get_uitspraak` | 通过ECLI获取单个判决的全文 + 元数据 + 关系。 |
| `get_uitspraken_bulk` | 通过ECLI一次获取最多10个判决。 |
| `list_waardelijsten` | 列出值列表（instanties、rechtsgebieden、proceduresoorten等）以构建有效过滤器。 |
| `lido_related` | ECLI周围的LiDO引用图：哪些引用它，哪些被它引用，法规引用。 |
## 搜索
`search_uitspraken` 是对官方开放数据馈送的**分面搜索** — 按日期、法院（`instantie`）、法律领域（`rechtsgebied`）和文档类型过滤。它不进行自由文本关键词匹配；将ECLI传递给 `query` 进行直接查找，或使用分面过滤器。`get_uitspraak` 从文档化的开放数据内容端点获取全文和元数据。
## 在MCP客户端中安装
**Claude 代码**（或任何读取 `claude_desktop_config.json` / `.mcp.json` 的客户端）：
```json
{
"mcpServers": {
"rechtspraak": {
"command": "npx",
"args": ["-y", "rechtspraak-mcp"]
}
}
}
```
```bash
claude mcp add rechtspraak -- npx -y rechtspraak-mcp
```
## 引用和来源链接
每个结果都带有其ECLI的链接：
- `links.deeplink` — 引用稳定的 `deeplink.rechtspraak.nl` URL，
- `links.rechtspraak` — 人类详情页面，
- `links.prudai` — [PrudAI](https://prudai.com) 判决查看器。
当代理引用某段内容时，工具会指示其将引用渲染为 Markdown 源链接，锚定在确切的摘录上：
```
[参见来源](https://prudai.com/uitspraak/ECLI:NL:HR:2023:1234?quote=%22<verbatim quote>%22)
```
## 配置
| 环境变量 | 默认值 | 描述 |
|---------|---------|-------------|
| `RECHTSPRAAK_HTTP_TIMEOUT_MS` | `30000` | 上游请求超时。 |
| `RECHTSPRAAK_BULK_CONCURRENCY` | `4` | 批量工具的并发性。 |
| `PRUDAI_BASE_URL` | `https://prudai.com` | 查看器深链接的基本URL。 |
| `RECHTSPRAAK_USER_AGENT` | `rechtspraak-mcp/…` | 发送到上游的User-Agent。 |
| `LIDO_REST_ENDPOINT` | KOOP 默认值 | 覆盖 LiDO 服务端点。 |
| `RECHTSPRAAK_DEBUG` | `0` | `1` 将上游请求记录到标准错误流。 |
## 开发
```bash
bun install
bun run typecheck
bun test
bun run build # → dist/ (Node 可运行，shebang 包)
bun src/index.ts # 从源代码运行
```
## 数据源和免责声明
案例数据由 Rechtspraak 所有，并作为开放数据通过 `data.rechtspraak.nl` 发布；引用图数据来自 KOOP 的 LiDO 服务（`linkeddata.overheid.nl`）。该项目是一个独立的开源客户端，与 Rechtspraak 或 KOOP 无关。在依赖结果之前，请始终与权威来源进行验证。
## 许可证
MIT © PrudAI。由 [PrudAI](https://prudai.com) 维护。
