krs-poland-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Piotr Kolawa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+![logo](logo.png)
+
+# krs-poland-mcp-server
+
+The MCP server for KRS Poland public API.
+
+## Installation
+
+To install the package, run the following command:
+
+```bash
+npm install -g krs-poland-mcp-server
+```
+
+## Usage with NPX
+
+You can also use `npx` to run the server without installing it globally:
+
+```bash
+npx krs-poland-mcp-server
+```
+
+## Usage
+
+After installation, you can run the server with the following command:
+
+```bash
+krs-poland-mcp-server
+```
+
+Alternatively, you can run the server using `npm start`:
+
+```bash
+npm start
+```
+
+## Usage with LLM clients
+
+This MCP server can be used to provide tools to LLM clients. To serve the tools, run the following command:
+
+```bash
+npx krs-poland-mcp-server serve
+```
+
+## Author
+
+Piotr Kolawa ([@pkolawa](https://github.com/pkolawa))
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/build/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { server } from "./server.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("KRS MCP Server running on stdio");
+}
+if (process.argv[1] === (import.meta && import.meta.url && new URL(import.meta.url).pathname)) {
+    main().catch((error) => {
+        console.error("Fatal error in main():", error);
+        process.exit(1);
+    });
+}

package/build/server.js

@@ -0,0 +1,17 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getKrsCurrentExtractTool } from "./tools/currentExtract.js";
+import { getKrsFullExtractTool } from "./tools/fullExtract.js";
+export const server = new McpServer({
+    name: "krs",
+    version: "1.0.0",
+});
+server.registerTool("Get Current KRS Record", {
+    title: "get-krs-current-extract",
+    description: "Get current status of the entity in KRS",
+    inputSchema: getKrsCurrentExtractTool.schema
+}, (params, extra) => getKrsCurrentExtractTool.handler(params, extra));
+server.registerTool("Get Full KRS Record", {
+    title: "get-krs-full-extract",
+    description: "Get full status of the entity in KRS",
+    inputSchema: getKrsFullExtractTool.schema
+}, (params, extra) => getKrsFullExtractTool.handler(params, extra));

package/build/tools/currentExtract.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { makeKRSRequest, buildExtractUrl } from "../utils/api.js";
+import { formatCompanyHeadline } from "../utils/format.js";
+/**
+ * KRS Open API – odpis aktualny (JSON)
+ * rejestr: 'P' (przedsiębiorców) | 'S' (stowarzyszeń)
+ */
+export const getKrsCurrentExtractTool = {
+    description: "Pobierz odpis aktualny KRS (JSON) dla wskazanego numeru KRS i rejestru (P/S).",
+    schema: {
+        krs: z
+            .string()
+            .regex(/^[0]\d{9}$/, "Numer KRS powinien mieć 10 cyfr")
+            .describe("Numer KRS (10 cyfr)"),
+        rejestr: z
+            .string()
+            .length(1, "Rejestr musi być pojedynczym znakiem: P lub S")
+            .regex(/^[pPsS]$/, "Rejestr musi być literą P lub S (wielkość liter bez znaczenia)")
+            .transform((val) => val.toUpperCase())
+            .describe("Rejestr: P – przedsiębiorców, S – stowarzyszeń (P/S, wielkość liter bez znaczenia)"),
+    },
+    handler: async (args, _extra) => {
+        const { krs, rejestr } = args;
+        const url = buildExtractUrl({ type: "OdpisAktualny", rejestr, krs });
+        const extract = await makeKRSRequest(url);
+        if (!extract) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Nie udało się pobrać odpisu aktualnego dla KRS ${krs} (${rejestr}).`,
+                        _meta: {},
+                    },
+                ],
+            };
+        }
+        const headline = formatCompanyHeadline(extract);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Odpis aktualny – ${headline}\n\n(Zwrócono obiekt JSON z odpisem aktualnym)\n\n${JSON.stringify(extract, null, 2)}`,
+                    _meta: {},
+                }
+            ],
+        };
+    },
+};

package/build/tools/fullExtract.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { makeKRSRequest, buildExtractUrl } from "../utils/api.js";
+import { formatCompanyHeadline } from "../utils/format.js";
+/**
+ * KRS Open API – odpis pełny (JSON)
+ */
+export const getKrsFullExtractTool = {
+    description: "Pobierz odpis pełny KRS (JSON) dla wskazanego numeru KRS i rejestru (P/S).",
+    schema: {
+        krs: z
+            .string()
+            .regex(/^[0]\d{9}$/, "Numer KRS powinien mieć 10 cyfr")
+            .describe("Numer KRS (10 cyfr)"),
+        rejestr: z
+            .string()
+            .length(1, "Rejestr musi być pojedynczym znakiem: P lub S")
+            .regex(/^[pPsS]$/, "Rejestr musi być literą P lub S (wielkość liter bez znaczenia)")
+            .transform((val) => val.toUpperCase())
+            .describe("Rejestr: P – przedsiębiorców, S – stowarzyszeń (P/S, wielkość liter bez znaczenia)"),
+    },
+    handler: async (args, _extra) => {
+        const { krs, rejestr } = args;
+        const url = buildExtractUrl({ type: "OdpisPelny", rejestr, krs });
+        const extract = await makeKRSRequest(url);
+        if (!extract) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Nie udało się pobrać odpisu pełnego dla KRS ${krs} (${rejestr}).`,
+                        _meta: {},
+                    },
+                ],
+            };
+        }
+        const headline = formatCompanyHeadline(extract);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Odpis pełny – ${headline}\n\n(Zwrócono obiekt JSON z odpisem pełnym)\n\n${JSON.stringify(extract, null, 2)}`,
+                    _meta: {},
+                }
+            ],
+        };
+    },
+};

package/build/tools/index.js

@@ -0,0 +1,6 @@
+import { getKrsCurrentExtractTool } from "./currentExtract.js";
+import { getKrsFullExtractTool } from "./fullExtract.js";
+export const tools = {
+    "get-krs-current-extract": getKrsCurrentExtractTool,
+    "get-krs-full-extract": getKrsFullExtractTool,
+};

package/build/types/krs.js

@@ -0,0 +1 @@
+export {};

package/build/utils/api.js

@@ -0,0 +1,28 @@
+const USER_AGENT = "krs-mcp/1.0";
+// Known public base for KRS Open API (REST returning JSON odpisy).
+// If MS changes routing/domains, adjust this single constant.
+const KRS_API_BASE = "https://api-krs.ms.gov.pl/api/krs";
+/**
+ * Build URL for KRS odpis (OdpisAktualny/OdpisPelny).
+ * Historically documented as REST with typ odpisu + KRS + rejestr (P/S), JSON in response.
+ * Example effective form (subject to MS routing):
+ *   `${KRS_API_BASE}/{typ_odpisu}/{rejestr}/{krs}`
+ */
+export function buildExtractUrl(opts) {
+    const { type, rejestr, krs } = opts;
+    // Prefer path params; keep query fallback if needed by future changes.
+    return `${KRS_API_BASE}/${type}/${krs}?rejestr=${rejestr}&format=json`;
+}
+export async function makeKRSRequest(url) {
+    const headers = { Accept: "application/json" };
+    try {
+        const res = await fetch(url, { headers });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        return (await res.json());
+    }
+    catch (err) {
+        console.error("KRS request error:", err);
+        return null;
+    }
+}

package/build/utils/format.js

@@ -0,0 +1,9 @@
+export function formatCompanyHeadline(extract) {
+    // The JSON structure differs by section; we pick common safe fields if present:
+    const krs = extract?.dzial1?.danePodstawowe?.numerKRS ?? extract?.podstawoweDane?.numerKRS ?? "KRS ?";
+    const name = extract?.dzial1?.danePodstawowe?.nazwa ??
+        extract?.podstawoweDane?.nazwa ??
+        extract?.nazwa ??
+        "Nieznana nazwa";
+    return `${name} (KRS ${krs})`;
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "krs-poland-mcp-server",
+  "version": "1.0.0",
+  "description": "The MCP server for KRS Poland public API.",
+  "main": "./src/index.ts",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc && echo '#!/usr/bin/env node' | cat - build/index.js > build/index.tmp && mv build/index.tmp build/index.js && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
+    "start": "node build/index.js"
+  },
+
+  "files": ["build"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pkolawa/mcp-krs-poland.git"
+  },
+  "keywords": ["mcp", "poland", "krs"],
+  "author": {
+    "name": "Piotr Kolawa",
+    "email": "piotr.kolawa@gmail.com"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "krs-poland-mcp-server": "./build/index.js"
+  },
+  "bugs": {
+    "url": "https://github.com/pkolawa/mcp-krs-poland/issues"
+  },
+  "homepage": "https://github.com/pkolawa/mcp-krs-poland#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.1",
+    "typescript": "^5.9.2"
+  }
+}