mcp-krs

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）查询**波兰国家法院登记册 / KRS（National Court Register）**的 MCP 服务。

为什么要用

律师事务所询问交易对手情况 -> Patron 返回完整的登记数据： 名称、法律形式、NIP、REGON、地址、股本、董事会组成、代表规则、商业代理人（prokurenci）、主要 PKD 代码、状态（正常运营 / 清算 / 破产）。此外还会提供司法部搜索工具的网址。

对合同工作至关重要：问题“此人能否独自代表 X 公司签署这份合同”可简化为两个步骤—— 使用 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 毫秒限流（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、代表规则“两名董事会成员共同办理”、董事会组成、商业代理人（prokurenci）以及网址。

GDPR 说明

司法部 API 在响应中会对董事会成员的个人数据进行遮蔽（根据 2023 年修正案，姓氏中的部分字母以星号显示）。Patron 会原样传递这些数据，不会尝试还原。如需查看完整姓氏，律师事务所用户需登录后在浏览器中打开司法部链接。

来源

API 规范来自官方文档 MS api-krs.ms.gov.pl。TypeScript 实现从零编写。

许可证

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。