mcp-nsa

mcp-nsa

安装（一条命令）

已发布到 npm 和 MCP Registry（io.github.matematicsolutions/mcp-nsa）。无需克隆即可运行：

npx -y @matematicsolutions/mcp-nsa

MCP 客户端配置（stdio）：

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

（从源代码构建的方法见下文。）

用于查询波兰行政法院判例的 MCP 服务——Naczelny Sad Administracyjny / NSA（最高行政法院）以及 16 个 Wojewodzkie Sady Administracyjne / WSA（地区行政法院）——通过 CBOSA（Centralna Baza Orzeczen Sadow Administracyjnych——行政法院中央判例数据库） （orzeczenia.nsa.gov.pl）。

为什么需要它

SAOS（普通法院判例分析系统）不收录行政法院的判例。 但实质性判例恰恰都出自这些法院：

• GDPR / 数据保护——对 UODO 主席决定向 WSA 提起的上诉，以及向 NSA 提起的撤销上诉
• 税务——个人税务裁定、税务机关决定
• 海关和消费税
• 行政许可、特许权
• 对公共行政活动的审查

mcp-nsa 弥补了这一缺口。覆盖范围：超过 2,390,000 条裁决（于 2026-07-08 实时核验，覆盖完整日期范围），时间跨度从 1981 年至今。

工具

• search(query, caseNumber?, court?, dateFrom?, dateTo?, pageNumber?)
  • 按关键词、案号、法院、日期搜索。获取排名前 5 条裁决的完整内容 （案号、法院、日期、合议庭、关键词、法律依据、摘录）。
• get_judgment(doc_id)——通过 10 位十六进制 doc_id 获取完整裁决 （来自 CBOSA URL，例如 7E50984BB7）。
• search_by_case(caseNumber)——快捷方式：按案号搜索 （例如 III OSK 1377/23、I SA/Gl 659/22）。

每个响应都包含带有以下字段的 structuredContent.citations： title、url（CBOSA）、case_number、court、judgment_date、 decision_type、snippet、doc_id。Patron 会自动读取此字段， 并在 UI 面板中显示为 “CBOSA 裁决（NSA / WSA - 行政法院）” 一节。

技术栈

• Node 18+
• @modelcontextprotocol/sdk
• Stdio 传输
• https + 正则表达式 HTML 解析器（除 SDK 外零外部依赖）
• 请求间隔限制为 500 ms（每秒 2 次请求）
• SSL：rejectUnauthorized: false——CBOSA 证书链在某些机器上有时不完整；裁决均为公开内容，不含个人身份信息，MITM 风险与收益相比可忽略不计。 参见：LDH issue #167。

构建与运行

npm install
npm run build
node dist/index.js   # starts the server on stdio

接入 Patron

在 patron/backend/mcp-servers.json 中（与 mcp-saos 和 mcp-eu-sparql 并列）：

{
  "name": "nsa",
  "transport": "stdio",
  "command": "node",
  "args": ["C:/Users/<YOUR-USERNAME>/mcp-nsa/dist/index.js"],
  "enabled": true
}

冒烟测试

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"s","version":"0"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search","arguments":{"query":"RODO art 6"}}}' \
  | node dist/index.js

应返回约 1500 条结果，以及排名前 5 的结果，其中包含波兰 NSA/WSA 案号、CBOSA URL 和 structuredContent.citations。

源流

此实现基于 legal-data-hunter/sources/PL/NSA 中的 HTTP/HTML 契约，使用 TypeScript 重写 （Python + BeautifulSoup，MIT）。它不导入源代码，而是复现 查询模式和 HTML 解析。

许可证

MIT。

MateMatic 的组成部分

此连接器会实时查询其数据源。它是 PATRON 中捆绑的波兰和欧盟数据源连接器之一，并且可与任何 MCP 客户端配合使用。

• 波兰，一个服务涵盖所有数据源：prawo-pl-mcp · 每个数据源各自独立：mcp-saos · mcp-nsa（本仓库） · mcp-isap · mcp-krs · mcp-eureka · kio-orzeczenia-mcp
• 欧盟：mcp-eu-sparql（实时） · mcp-eu-compliance（离线语料库）
• 包含引用关系图的波兰和欧盟法律整理语料库：Repertorium

mcp-saos、mcp-nsa、mcp-isap、mcp-krs 和 mcp-eu-sparql 共用一个 structuredContent.citations 契约：每个工具都会返回一个 {title, url, snippet?, ...metadata} 数组， 法律 Agent 可直接在其引用面板中呈现这些内容。

完整组织简介请参阅 matematicsolutions/.github 。