krs-poland-mcp-server 1.0.1 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "krs-poland-mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "The MCP server for KRS Poland public API.",
   "main": "./src/index.ts",
   "scripts": {
@@ -8,12 +8,9 @@
     "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"],
-  "engines": { "node": ">=18.17" },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pkolawa/mcp-krs-poland.git"
+    "url": "git+https://github.com/pkolawa/krs-poland-mcp-server.git"
   },
   "keywords": ["mcp", "poland", "krs"],
   "author": {
@@ -26,9 +23,9 @@
     "krs-poland-mcp-server": "./build/index.js"
   },
   "bugs": {
-    "url": "https://github.com/pkolawa/mcp-krs-poland/issues"
+    "url": "https://github.com/pkolawa/krs-poland-mcp-server/issues"
   },
-  "homepage": "https://github.com/pkolawa/mcp-krs-poland#readme",
+  "homepage": "https://github.com/pkolawa/krs-poland-mcp-server#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.76"

package/src/index.ts

@@ -0,0 +1,15 @@
+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/src/server.ts

@@ -0,0 +1,27 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getKrsCurrentExtractTool } from "./tools/currentExtract.js";
+import { getKrsFullExtractTool } from "./tools/fullExtract.js";
+import { z } from "zod";
+
+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/src/tools/currentExtract.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { makeKRSRequest, buildExtractUrl } from "../utils/api.js";
+import { KrsExtract } from "../types/krs.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() as "P" | "S")
+        .describe("Rejestr: P – przedsiębiorców, S – stowarzyszeń (P/S, wielkość liter bez znaczenia)"),
+  },
+  handler: async (args: { krs: string; rejestr: string}, _extra: unknown) => {
+    const { krs, rejestr } = args;
+    const url = buildExtractUrl({ type: "OdpisAktualny", rejestr, krs });
+    const extract = await makeKRSRequest<KrsExtract>(url);
+
+    if (!extract) {
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `Nie udało się pobrać odpisu aktualnego dla KRS ${krs} (${rejestr}).`,
+            _meta: {},
+          },
+        ],
+      };
+    }
+
+    const headline = formatCompanyHeadline(extract);
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: `Odpis aktualny – ${headline}\n\n(Zwrócono obiekt JSON z odpisem aktualnym)\n\n${JSON.stringify(extract, null, 2)}`,
+          _meta: {},
+        }
+      ],
+    };
+  },
+};

package/src/tools/fullExtract.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { makeKRSRequest, buildExtractUrl } from "../utils/api.js";
+import { KrsExtract } from "../types/krs.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() as "P" | "S")
+        .describe("Rejestr: P – przedsiębiorców, S – stowarzyszeń (P/S, wielkość liter bez znaczenia)"),
+  },
+  handler: async (args: { krs: string; rejestr: "P" | "S" }, _extra: unknown) => {
+    const { krs, rejestr } = args;
+    const url = buildExtractUrl({ type: "OdpisPelny", rejestr, krs });
+    const extract = await makeKRSRequest<KrsExtract>(url);
+
+    if (!extract) {
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `Nie udało się pobrać odpisu pełnego dla KRS ${krs} (${rejestr}).`,
+            _meta: {},
+          },
+        ],
+      };
+    }
+
+    const headline = formatCompanyHeadline(extract);
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: `Odpis pełny – ${headline}\n\n(Zwrócono obiekt JSON z odpisem pełnym)\n\n${JSON.stringify(extract, null, 2)}`,
+          _meta: {},
+        }
+      ],
+    };
+  },
+};

package/src/tools/index.ts

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

package/src/types/krs.ts

@@ -0,0 +1,25 @@
+export interface KrsExtract {
+  // Many providers show a top-level split into działy (1..6) for odpisy.
+  dzial1?: {
+    danePodstawowe?: {
+      numerKRS?: string;
+      nazwa?: string;
+      formaPrawna?: string;
+      siedziba?: string;
+      adres?: string;
+      nip?: string;
+      regon?: string;
+    };
+    [key: string]: unknown;
+  };
+  podstawoweDane?: {
+    numerKRS?: string;
+    nazwa?: string;
+    formaPrawna?: string;
+    nip?: string;
+    regon?: string;
+    [key: string]: unknown;
+  };
+  nazwa?: string;
+  [key: string]: unknown; // keep schema-open for all other sections/fields
+}

package/src/utils/api.ts

@@ -0,0 +1,31 @@
+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";
+
+type ExtractType = "OdpisAktualny" | "OdpisPelny";
+
+/**
+ * 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: { type: ExtractType; rejestr: string; krs: string }): string {
+  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<T>(url: string): Promise<T | null> {
+  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()) as T;
+  } catch (err) {
+    console.error("KRS request error:", err);
+    return null;
+  }
+}

package/src/utils/format.ts

@@ -0,0 +1,13 @@
+import { KrsExtract } from "../types/krs.js";
+
+export function formatCompanyHeadline(extract: KrsExtract): string {
+  // 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/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./build",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}