teryt-mcp 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import * as _mcp_craftman_core from '@mcp-craftman/core';
+import { RuntimeConfig } from '@mcp-craftman/node';
+
+type DatasetCode = "TERC" | "SIMC" | "ULIC" | "WMRODZ";
+
+type SourceFile = {
+    readonly dataset: DatasetCode;
+    readonly content: Uint8Array;
+    readonly sourceUrl: string;
+    readonly stateDate: string;
+};
+type TerytSource = {
+    readonly download: (dataset: DatasetCode) => Promise<SourceFile>;
+};
+
+type CreateAppOverrides = {
+    readonly syncSource?: TerytSource;
+};
+declare function createApp(config?: RuntimeConfig, overrides?: CreateAppOverrides): _mcp_craftman_core.McpApp;
+
+type CliIo = {
+    readonly appFactory?: typeof createApp;
+    readonly env: NodeJS.ProcessEnv;
+    readonly stderr: NodeJS.WritableStream;
+    readonly stdout: NodeJS.WritableStream;
+};
+declare function runCli(argv?: readonly string[], io?: CliIo): Promise<void>;
+
+export { runCli };

package/dist/cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import {
+  createApp,
+  getServerStatus,
+  serve
+} from "./chunk-YEPFIU35.js";
+
+// src/cli.ts
+import { basename } from "path";
+import { loadRuntimeConfig } from "@mcp-craftman/node";
+import { callTool, mcpCraftmanCoreVersion } from "@mcp-craftman/core";
+async function runCli(argv = process.argv.slice(2), io = defaultIo()) {
+  const [command, ...args] = argv;
+  if (command === "serve") {
+    await serve(loadRuntimeConfig(io.env));
+    return;
+  }
+  if (command === "status") {
+    const config = loadRuntimeConfig(io.env);
+    writeJson(
+      io.stdout,
+      getServerStatus({
+        dataDir: config.dataDir,
+        frameworkVersion: mcpCraftmanCoreVersion,
+        transport: config.transport
+      })
+    );
+    return;
+  }
+  if (command === "source-status") {
+    await writeCliToolResult(io.stdout, "source_status", {}, io);
+    return;
+  }
+  if (command === "sync") {
+    await writeCliToolResult(io.stdout, "sync_database", { mode: parseSyncMode(args) }, io);
+    return;
+  }
+  if (command === "search") {
+    await runSearchCommand(args, io);
+    return;
+  }
+  throw new Error(`Unknown command: ${command ?? "<missing>"}`);
+}
+function writeJson(stream, value) {
+  stream.write(`${JSON.stringify(value, null, 2)}
+`);
+}
+async function writeCliToolResult(stream, toolName, input, io) {
+  const result = await callTool((io.appFactory ?? createApp)(loadRuntimeConfig(io.env)), toolName, input);
+  writeJson(stream, result.structuredContent);
+}
+function defaultIo() {
+  return {
+    env: process.env,
+    stderr: process.stderr,
+    stdout: process.stdout
+  };
+}
+async function runSearchCommand(args, io) {
+  const [scope, ...queryParts] = args;
+  if (scope !== "places") {
+    throw new Error("search requires scope: places.");
+  }
+  const { limit, query } = parseSearchArgs(queryParts);
+  await writeCliToolResult(
+    io.stdout,
+    "search_places",
+    {
+      limit,
+      query
+    },
+    io
+  );
+}
+function parseSearchArgs(args) {
+  const queryParts = [];
+  let limit;
+  for (let index = 0; index < args.length; index += 1) {
+    const value = args[index];
+    if (value === "--limit") {
+      limit = parseLimit(args[index + 1]);
+      index += 1;
+      continue;
+    }
+    queryParts.push(value ?? "");
+  }
+  const query = queryParts.join(" ").trim();
+  if (!query) {
+    throw new Error("search places requires query.");
+  }
+  return limit === void 0 ? { query } : { limit, query };
+}
+function parseLimit(value) {
+  const limit = Number(value);
+  if (!Number.isInteger(limit) || limit < 1) {
+    throw new Error("search --limit requires a positive integer.");
+  }
+  return limit;
+}
+function parseSyncMode(args) {
+  if (args.includes("--force")) {
+    return "force";
+  }
+  const modeIndex = args.indexOf("--mode");
+  if (modeIndex >= 0) {
+    const mode = args[modeIndex + 1];
+    if (mode === "missing" || mode === "stale" || mode === "force") {
+      return mode;
+    }
+    throw new Error("sync --mode requires: missing | stale | force.");
+  }
+  return "missing";
+}
+function isCliEntrypoint(argvPath = process.argv[1]) {
+  const entrypoint = argvPath ? basename(argvPath) : "";
+  return entrypoint === "teryt-mcp" || entrypoint === "cli.js";
+}
+if (isCliEntrypoint()) {
+  runCli().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}
+`);
+    process.exitCode = 1;
+  });
+}
+export {
+  runCli
+};

package/dist/main.d.ts

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

package/dist/main.js

@@ -0,0 +1,6 @@
+import {
+  serve
+} from "./chunk-YEPFIU35.js";
+
+// src/main.ts
+await serve();

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "teryt-mcp",
+  "version": "0.1.0",
+  "private": false,
+  "description": "MCP server for the official Polish TERYT registry.",
+  "type": "module",
+  "packageManager": "pnpm@10.12.1",
+  "bin": {
+    "teryt-mcp": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/main.ts src/cli.ts --format esm --dts --clean",
+    "prepare": "git rev-parse --is-inside-work-tree >/dev/null 2>&1 && git config core.hooksPath .githooks || true",
+    "quality": "mcp-craftman quality",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@mcp-craftman/core": "^0.1.1",
+    "@mcp-craftman/node": "^0.1.1",
+    "fflate": "^0.8.3",
+    "sql.js": "^1.14.1"
+  },
+  "devDependencies": {
+    "@mcp-craftman/cli": "^0.1.1",
+    "@types/node": "^24.0.3",
+    "@types/sql.js": "^1.4.11",
+    "@vitest/coverage-v8": "^3.2.4",
+    "dependency-cruiser": "^13.1.5",
+    "eslint": "^9.29.0",
+    "eslint-plugin-sonarjs": "^3.0.3",
+    "knip": "^5.61.3",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.34.1",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}