pseudonym-mcp 0.1.0

package/dist/setup/check-ollama.js

@@ -0,0 +1,58 @@
+/**
+ * Check whether Ollama is running and whether the required model is available.
+ */
+export async function checkOllama(baseUrl, model, timeoutMs = 3_000) {
+    // Step 1: Check reachability
+    let tagsRes;
+    try {
+        const controller = new AbortController();
+        const t = setTimeout(() => controller.abort(), timeoutMs);
+        tagsRes = await fetch(`${baseUrl}/api/tags`, { signal: controller.signal });
+        clearTimeout(t);
+    }
+    catch (err) {
+        return {
+            running: false,
+            modelAvailable: false,
+            error: `Ollama is not reachable at ${baseUrl}: ${String(err)}`,
+        };
+    }
+    if (!tagsRes.ok) {
+        return {
+            running: false,
+            modelAvailable: false,
+            error: `Ollama returned HTTP ${tagsRes.status} at ${baseUrl}`,
+        };
+    }
+    // Step 2: Check model availability
+    try {
+        const data = (await tagsRes.json());
+        const models = data.models ?? [];
+        const modelAvailable = models.some((m) => m.name === model || m.name.startsWith(`${model}:`));
+        return { running: true, modelAvailable };
+    }
+    catch {
+        return { running: true, modelAvailable: false };
+    }
+}
+/**
+ * Print a user-friendly warning to stderr if Ollama is unavailable or
+ * the required model is missing. Never throws — errors are non-fatal.
+ */
+export async function printOllamaStatus(baseUrl, model) {
+    const result = await checkOllama(baseUrl, model);
+    if (!result.running) {
+        process.stderr.write(`\n[pseudonym-mcp] WARNING: Ollama not detected at ${baseUrl}\n` +
+            `  Install Ollama: https://ollama.com/download\n` +
+            `  Then start it: ollama serve\n` +
+            `  The LLM NER phase will be skipped until Ollama is available.\n` +
+            `  Use --engines regex to suppress this warning.\n\n`);
+        return;
+    }
+    if (!result.modelAvailable) {
+        process.stderr.write(`\n[pseudonym-mcp] WARNING: Model "${model}" not found in Ollama.\n` +
+            `  Pull it with: ollama pull ${model}\n` +
+            `  The LLM NER phase will fail gracefully until the model is available.\n\n`);
+    }
+}
+//# sourceMappingURL=check-ollama.js.map

package/dist/setup/check-ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-ollama.js","sourceRoot":"","sources":["../../src/setup/check-ollama.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,KAAa,EACb,SAAS,GAAG,KAAK;IAEjB,6BAA6B;IAC7B,IAAI,OAAiB,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAA;QACzD,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,WAAW,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QAC3E,YAAY,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,cAAc,EAAE,KAAK;YACrB,KAAK,EAAE,8BAA8B,OAAO,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE;SAC/D,CAAA;IACH,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,cAAc,EAAE,KAAK;YACrB,KAAK,EAAE,wBAAwB,OAAO,CAAC,MAAM,OAAO,OAAO,EAAE;SAC9D,CAAA;IACH,CAAC;IAED,mCAAmC;IACnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAyC,CAAA;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAA;QAChC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAC1D,CAAA;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAA;IACjD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qDAAqD,OAAO,IAAI;YAC9D,iDAAiD;YACjD,iCAAiC;YACjC,kEAAkE;YAClE,qDAAqD,CACxD,CAAA;QACD,OAAM;IACR,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qCAAqC,KAAK,0BAA0B;YAClE,+BAA+B,KAAK,IAAI;YACxC,4EAA4E,CAC/E,CAAA;IACH,CAAC;AACH,CAAC"}

package/mcp-config.json

@@ -0,0 +1,8 @@
+{
+  "lang": "en",
+  "engines": "hybrid",
+  "ollamaModel": "llama3",
+  "ollamaBaseUrl": "http://localhost:11434",
+  "autoUnmask": false,
+  "strictValidation": true
+}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "pseudonym-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for privacy-preserving pseudonymization of sensitive data before cloud LLM processing",
+  "type": "module",
+  "bin": {
+    "pseudonym-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "types": "./dist/cli.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/cli.js",
+      "types": "./dist/cli.d.ts"
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "start": "node dist/cli.js",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "privacy",
+    "pseudonymization",
+    "anonymization",
+    "pii",
+    "pii-masking",
+    "pii-redaction",
+    "nlp",
+    "ner",
+    "named-entity-recognition",
+    "gdpr",
+    "gdpr-compliance",
+    "rodo",
+    "ai-privacy",
+    "llm-privacy",
+    "data-minimisation",
+    "privacy-by-design",
+    "pesel",
+    "iban",
+    "ollama",
+    "claude",
+    "zero-trust"
+  ],
+  "author": "Adrian Wolczuk",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/woladi/pseudonym-mcp.git"
+  },
+  "homepage": "https://github.com/woladi/pseudonym-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/woladi/pseudonym-mcp/issues"
+  },
+  "files": [
+    "dist/",
+    "mcp-config.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^14.0.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@release-it/conventional-changelog": "^10.0.0",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "@vitest/ui": "^3.0.0",
+    "release-it": "^19.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "release-it": {
+    "$schema": "https://unpkg.com/release-it/schema/release-it.json",
+    "git": {
+      "commitMessage": "chore: release v${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true,
+      "releaseName": "v${version}"
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": "conventionalcommits",
+        "infile": "CHANGELOG.md"
+      }
+    }
+  }
+}