mcp-krs について
司法省 API を通じてポーランド国家裁判所登記簿(KRS)のデータを取得する MCP サーバーです。最新または全履歴の登記情報に加え、取締役会の構成や代表規則も確認できます。
主な機能
- 01最新の会社登記情報を取得
- 02登記履歴付きの全情報を取得
- 03取締役会と代表規則を確認
- 04商業代理人の情報を収録
- 05構造化された引用情報を返却
活用シーン
- 01ポーランド企業の登記情報を確認
- 02会社の代表権を確認
- 03取締役会構成と商業代理人を調査
- 04契約相手の確認に活用
MCP 対応
stdio 経由で MCP クライアントに、司法省の公式 API から KRS の法人情報を取得するツールを提供します。応答には構造化された登記情報と引用フィールドが含まれます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
3掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| krs | string | はい | KRS 番号(1~10 桁。例:'28860' → 自動的に '0000028860' に補完)。 |
| rejestr | enum | いいえ | 登録簿:'P' = 事業者(既定)、'S' = 協会。P | S |
詳細
mcp-krs
インストール(ワンコマンド)
npm + MCP Registry(io.github.matematicsolutions/mcp-krs)で公開されています。クローンせずに実行できます:
npx -y @matematicsolutions/mcp-krs
MCP クライアントの設定(stdio):
{ "mcpServers": { "mcp-krs": { "command": "npx", "args": ["-y", "@matematicsolutions/mcp-krs"] } } }
(ソースからのビルドについては以下を参照してください。)
公式の無料の司法省(Ministerstwo Sprawiedliwosci)API(api-krs.ms.gov.pl/api/krs)を利用する、**Krajowy Rejestr Sadowy / KRS(国立裁判所登記簿)**用の MCP サーバーです。
理由
法律事務所が取引先について問い合わせると、Patron が登記情報一式を返します: 名称、法人形態、NIP、REGON、住所、資本金、役員構成、代表権に関する規則、商業代理人(prokurenci)、主たる PKD コード、ステータス(有効/清算中/破産)。さらに、司法省の検索ツールへの URL も返します。
契約業務では非常に重要です。「この人物は会社 X を代表して単独でこの契約に署名できるか」という問いは、2 つの手順に集約されます。KRS 番号を指定して krs__get_board を実行し、代表権に関する規則と署名者を照合します。
ツール
get_entity(krs, rejestr?)- 現在の抄本(法人情報一式)。get_entity_full(krs, rejestr?)- 全抄本(登記履歴を含む)。get_board(krs, rejestr?)- 簡易形式:代表権に関する情報のみ(規則 + 構成)+ 商業代理人(prokurenci)。
パラメーター:
krs- 1~10 桁の数字。先頭のゼロは自動で補完されます (28860→0000028860)。rejestr-P(事業者登記簿、デフォルト)またはS(団体登記簿)。
すべてのレスポンスには、次のフィールドを含む structuredContent.citations が含まれます:
title、url(司法省の検索ページ)、krs、nazwa、nip、regon、
forma_prawna、status、miejscowosc、sad_rejestrowy、rejestr。
Patron はこのフィールドを自動的に読み取り、UI パネルに **「Krajowy Rejestr Sadowy (KRS - MS)」**セクションとして表示します。
技術スタック
- Node 18+(組み込みの
fetch) @modelcontextprotocol/sdk- Stdio トランスポート
- 500 ms のスロットリング(2 リクエスト/秒)- 司法省の API は寛容ですが、適切な頻度で利用してください
ビルドと実行
npm install
npm run build
node dist/index.js
Patron への組み込み
patron/backend/mcp-servers.json 内:
{
"name": "krs",
"transport": "stdio",
"command": "node",
"args": ["C:/Users/<YOUR-USER>/mcp-krs/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":"get_board","arguments":{"krs":"28860"}}}' \
| node dist/index.js
ORLEN SA、代表権に関する規則「役員 2 名による共同での行為」、役員構成、商業代理人(prokurenci)+ URL が返されます。
GDPR に関する注意
司法省の API は、レスポンス内の役員の個人データをマスキングして返します(2023 年の改正後、姓の一部がアスタリスクで表示されます)。Patron はこのデータを加工せずにそのまま渡し、マスキングを解除しません。姓の全表記を確認するには、法律事務所のユーザーがログイン後、ブラウザーで司法省のリンクを開きます。
出典
API 仕様は公式ドキュメント MS api-krs.ms.gov.plに基づいています。TypeScript による実装は一から作成しました。
ライセンス
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 つのサーバーを複数のクライアントで再利用できます。