mcp-nsa について
mcp-nsaは、CBOSAからポーランドの行政裁判所の判決を検索するMCPサーバーです。最高行政裁判所NSAと16の地方行政裁判所WSAを対象とし、法律調査向けに判例検索、全文、構造化された事件情報と引用を提供します。
主な機能
- 01NSA・WSA判決の検索
- 02事件番号・裁判所・日付での絞り込み
- 03文書IDによる判決全文の取得
- 04構造化されたCBOSA引用の返却
活用シーン
- 01ポーランド行政判例の調査
- 02データ保護や税務に関する判決の検索
- 03事件番号から判決を取得
MCP 対応
判決検索、事件番号検索、全文取得のツールをMCPクライアントに提供します。応答にはCBOSAへのリンクを含む構造化引用情報が含まれます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
3掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| court | enum | いいえ | 裁判所名(正式名称)。デフォルトではすべての行政裁判所が対象です。Naczelny Sąd Administracyjny | Wojewódzki Sąd Administracyjny w Białymstoku | Wojewódzki Sąd Administracyjny w Bydgoszczy | Wojewódzki Sąd Administracyjny w Gdańsku | Wojewódzki Sąd Administracyjny w Gliwicach | Wojewódzki Sąd Administracyjny w Gorzowie Wielkopolskim | Wojewódzki Sąd Administracyjny w Kielcach | Wojewódzki Sąd Administracyjny w Krakowie | Wojewódzki Sąd Administracyjny w Lublinie | Wojewódzki Sąd Administracyjny w Łodzi | Wojewódzki Sąd Administracyjny w Olsztynie | Wojewódzki Sąd Administracyjny w Opolu | Wojewódzki Sąd Administracyjny w Poznaniu | Wojewódzki Sąd Administracyjny w Rzeszowie | Wojewódzki Sąd Administracyjny w Szczecinie | Wojewódzki Sąd Administracyjny w Warszawie | Wojewódzki Sąd Administracyjny we Wrocławiu |
| query | string | いいえ | キーワード(CBOSA の 'wszystkieSlowa' フィールド)。例:'RODO art 6' または 'tajemnica skarbowa'。 |
| dateTo | string | いいえ | 裁判日(終了)(YYYY-MM-DD)。 |
| dateFrom | string | いいえ | 裁判日(開始)(YYYY-MM-DD)。 |
| caseNumber | string | いいえ | Sygnatura akt。例:'III OSK 1377/23'(NSA)または 'I SA/Gl 659/22'(WSA)。 |
| pageNumber | number | いいえ | ページ番号(1 から)。CBOSA は常に 1 ページあたり 10 件の結果を返します。ページネーションに使用します。 |
詳細
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文字の16進数の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 req/s)
- SSL:
rejectUnauthorized: false- CBOSAの証明書チェーンは一部のマシンで不完全な場合があります。公開判例であり、個人を特定できる情報はなく、メリットに対する中間者攻撃のリスクは無視できる程度です。 参照: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件のヒットと、ポーランドのNSA/WSA事件番号、CBOSAのURL、およびstructuredContent.citationsを含む上位5件が返されるはずです。
開発の経緯
legal-data-hunter/sources/PL/NSAのHTTP/HTML仕様に基づき、TypeScriptで実装し直しました
(Python + BeautifulSoup、MIT)。ソースコードはインポートせず、クエリパターンとHTML解析を再現しています。
ライセンス
MIT。
MateMatic の一部
このコネクターは、ソースにリアルタイムでクエリを実行します。PATRON に同梱されているポーランドおよび EU のソースコネクターの 1 つで、あらゆる MCP クライアントで動作します。
- ポーランド、すべてのソースを扱う 1 つのサーバー:prawo-pl-mcp · 各ソースを個別に扱うもの:mcp-saos · mcp-nsa(このリポジトリ) · mcp-isap · mcp-krs · mcp-eureka · kio-orzeczenia-mcp
- 欧州連合:mcp-eu-sparql(リアルタイム) · mcp-eu-compliance(オフラインコーパス)
- 引用グラフを備えた、ポーランドおよび EU 法の整備済みコーパス:Repertorium
mcp-saos、mcp-nsa、mcp-isap、mcp-krs、mcp-eu-sparql は、共通の structuredContent.citations
契約を採用しています。各ツールは、法務エージェントが引用パネルにそのまま表示できる
{title, url, snippet?, ...metadata} の配列を返します。
組織のプロフィール全文については、matematicsolutions/.github をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。