@privacyscrubber/mcp-server 2.2.2 → 2.2.5

package/install.js

@@ -1,63 +1,313 @@
 #!/usr/bin/env node
 
+/**
+ * PrivacyScrubber MCP Server Universal Auto-Configurator & Installer
+ * Supports: Claude Desktop, Cursor (Global & Workspace), Windsurf, Cline / Roo-Code
+ * 
+ * Safely merges 'privacyscrubber' into mcpServers without corrupting or deleting existing tools.
+ */
+
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import { fileURLToPath } from 'url';
 
-console.log('🛡️ PrivacyScrubber MCP Server 1-Click Installer');
-console.log('================================================\n');
-
-const mcpConfig = {
+const MCP_CONFIG_SNIPPET = {
   command: "npx",
   args: ["-y", "@privacyscrubber/mcp-server"]
 };
 
-let claudeConfigPath = '';
-if (process.platform === 'darwin') {
-  claudeConfigPath = path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
-} else if (process.platform === 'win32') {
-  claudeConfigPath = path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
-} else {
-  // Linux fallback, though Claude Desktop is not officially supported on Linux yet, we check common paths
-  claudeConfigPath = path.join(os.homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+export function getSupportedTargets(customWorkspaceDir = null) {
+  const home = os.homedir();
+  const platform = process.platform;
+  const targets = [];
+
+  // 1. Claude Desktop
+  let claudePath = '';
+  if (platform === 'darwin') {
+    claudePath = path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+  } else if (platform === 'win32') {
+    claudePath = path.join(process.env.APPDATA || path.join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+  } else {
+    claudePath = path.join(home, '.config', 'Claude', 'claude_desktop_config.json');
+  }
+  targets.push({
+    id: 'claude',
+    name: 'Claude Desktop',
+    path: claudePath,
+    autoCreate: true
+  });
+
+  // 2. Cursor Global (~/.cursor/mcp.json)
+  const cursorGlobalHome = path.join(home, '.cursor', 'mcp.json');
+  targets.push({
+    id: 'cursor',
+    name: 'Cursor (Global ~/.cursor/mcp.json)',
+    path: cursorGlobalHome,
+    autoCreate: true
+  });
+
+  // 3. Cursor Global Storage (Application Support / AppData)
+  let cursorStoragePath = '';
+  if (platform === 'darwin') {
+    cursorStoragePath = path.join(home, 'Library', 'Application Support', 'Cursor', 'User', 'globalStorage', 'cursor.mcp', 'mcp.json');
+  } else if (platform === 'win32') {
+    cursorStoragePath = path.join(process.env.APPDATA || path.join(home, 'AppData', 'Roaming'), 'Cursor', 'User', 'globalStorage', 'cursor.mcp', 'mcp.json');
+  } else {
+    cursorStoragePath = path.join(home, '.config', 'Cursor', 'User', 'globalStorage', 'cursor.mcp', 'mcp.json');
+  }
+  targets.push({
+    id: 'cursor-storage',
+    name: 'Cursor (App Storage)',
+    path: cursorStoragePath,
+    autoCreate: false
+  });
+
+  // 4. Cursor Workspace (if .cursor dir or project exists in cwd)
+  const cwd = customWorkspaceDir || process.cwd();
+  const cursorWorkspacePath = path.join(cwd, '.cursor', 'mcp.json');
+  targets.push({
+    id: 'cursor-workspace',
+    name: `Cursor (Workspace: ${path.basename(cwd)}/.cursor/mcp.json)`,
+    path: cursorWorkspacePath,
+    autoCreate: fs.existsSync(path.join(cwd, '.cursor'))
+  });
+
+  // 5. Windsurf (~/.codeium/windsurf/mcp_config.json)
+  const windsurfPath = path.join(
+    platform === 'win32' ? (process.env.USERPROFILE || home) : home,
+    '.codeium',
+    'windsurf',
+    'mcp_config.json'
+  );
+  targets.push({
+    id: 'windsurf',
+    name: 'Windsurf (Codeium)',
+    path: windsurfPath,
+    autoCreate: false
+  });
+
+  // 6. Cline (VS Code Extension)
+  let clinePath = '';
+  if (platform === 'darwin') {
+    clinePath = path.join(home, 'Library', 'Application Support', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
+  } else if (platform === 'win32') {
+    clinePath = path.join(process.env.APPDATA || path.join(home, 'AppData', 'Roaming'), 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
+  } else {
+    clinePath = path.join(home, '.config', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
+  }
+  targets.push({
+    id: 'cline',
+    name: 'Cline (VS Code)',
+    path: clinePath,
+    autoCreate: false
+  });
+
+  // 7. Roo-Code (VS Code Extension)
+  let rooPath = '';
+  if (platform === 'darwin') {
+    rooPath = path.join(home, 'Library', 'Application Support', 'Code', 'User', 'globalStorage', 'rooveterinaryinc.roo-cline', 'settings', 'cline_mcp_settings.json');
+  } else if (platform === 'win32') {
+    rooPath = path.join(process.env.APPDATA || path.join(home, 'AppData', 'Roaming'), 'Code', 'User', 'globalStorage', 'rooveterinaryinc.roo-cline', 'settings', 'cline_mcp_settings.json');
+  } else {
+    rooPath = path.join(home, '.config', 'Code', 'User', 'globalStorage', 'rooveterinaryinc.roo-cline', 'settings', 'cline_mcp_settings.json');
+  }
+  targets.push({
+    id: 'roo',
+    name: 'Roo-Code (VS Code)',
+    path: rooPath,
+    autoCreate: false
+  });
+
+  return targets;
 }
 
-// 1. Configure Claude Desktop
-let installedClaude = false;
-try {
-  let configDir = path.dirname(claudeConfigPath);
-  if (!fs.existsSync(configDir)) {
-    fs.mkdirSync(configDir, { recursive: true });
+export function parseArgs(rawArgs = process.argv.slice(2)) {
+  const options = {
+    dryRun: false,
+    remove: false,
+    all: false,
+    targets: [],
+    help: false
+  };
+
+  for (const arg of rawArgs) {
+    if (arg === '--dry-run') options.dryRun = true;
+    else if (arg === '--remove' || arg === '--uninstall') options.remove = true;
+    else if (arg === '--all') options.all = true;
+    else if (arg === '--claude') options.targets.push('claude');
+    else if (arg === '--cursor') options.targets.push('cursor', 'cursor-storage', 'cursor-workspace');
+    else if (arg === '--windsurf') options.targets.push('windsurf');
+    else if (arg === '--cline') options.targets.push('cline', 'roo');
+    else if (arg === '--workspace') options.targets.push('cursor-workspace');
+    else if (arg === '--help' || arg === '-h') options.help = true;
   }
 
-  let config = {};
-  if (fs.existsSync(claudeConfigPath)) {
-    const rawData = fs.readFileSync(claudeConfigPath, 'utf8');
-    if (rawData.trim() !== '') {
-      config = JSON.parse(rawData);
+  return options;
+}
+
+export function safeMergeMcpConfig(filePath, snippet = MCP_CONFIG_SNIPPET, remove = false) {
+  let existingContent = '';
+  let configObj = {};
+  const fileExisted = fs.existsSync(filePath);
+
+  if (fileExisted) {
+    existingContent = fs.readFileSync(filePath, 'utf8');
+    if (existingContent.trim()) {
+      try {
+        configObj = JSON.parse(existingContent);
+      } catch (e) {
+        // Backup corrupt file before modifying
+        const bakPath = `${filePath}.bak.${Date.now()}`;
+        fs.writeFileSync(bakPath, existingContent, 'utf8');
+        return {
+          success: false,
+          error: `Existing JSON was invalid (${e.message}). Created backup: ${bakPath}`
+        };
+      }
     }
   }
 
-  if (!config.mcpServers) {
-    config.mcpServers = {};
+  if (typeof configObj !== 'object' || configObj === null || Array.isArray(configObj)) {
+    configObj = {};
   }
 
-  config.mcpServers['privacyscrubber'] = mcpConfig;
+  if (!configObj.mcpServers || typeof configObj.mcpServers !== 'object' || Array.isArray(configObj.mcpServers)) {
+    configObj.mcpServers = {};
+  }
 
-  fs.writeFileSync(claudeConfigPath, JSON.stringify(config, null, 2), 'utf8');
-  console.log(`✅ [Claude Desktop] Successfully injected PrivacyScrubber MCP into:`);
-  console.log(`   ${claudeConfigPath}`);
-  installedClaude = true;
-} catch (e) {
-  console.log(`⚠️ [Claude Desktop] Could not configure automatically: ${e.message}`);
+  if (remove) {
+    if (configObj.mcpServers['privacyscrubber']) {
+      delete configObj.mcpServers['privacyscrubber'];
+    } else {
+      return { success: true, modified: false, message: 'privacyscrubber was not present' };
+    }
+  } else {
+    configObj.mcpServers['privacyscrubber'] = snippet;
+  }
+
+  const updatedJson = JSON.stringify(configObj, null, 2) + '\n';
+  return {
+    success: true,
+    modified: true,
+    fileExisted,
+    updatedJson,
+    serverCount: Object.keys(configObj.mcpServers).length
+  };
 }
 
-console.log('\n---');
-console.log('\n🔵 [Cursor / Windsurf Users]');
-console.log('To install PrivacyScrubber in Cursor or Windsurf:');
-console.log('1. Open Settings -> Features -> MCP Servers (or type "MCP" in settings).');
-console.log('2. Click "+ Add New MCP Server".');
-console.log('3. Set Name: privacyscrubber');
-console.log('4. Set Type: command');
-console.log('5. Set Command: npx -y @privacyscrubber/mcp-server');
-console.log('\n🚀 Installation complete! Restart your IDE or Claude Desktop to start redacting PII locally.');
+export async function runInstaller(rawArgs = process.argv.slice(2)) {
+  const options = parseArgs(rawArgs);
+
+  if (options.help) {
+    console.log(`
+PrivacyScrubber MCP Auto-Configurator
+Usage:
+  npx @privacyscrubber/mcp-server init [options]
+  npx @privacyscrubber/mcp-server-install [options]
+
+Options:
+  --all           Configure all detected and standard client paths
+  --cursor        Configure Cursor only (~/.cursor/mcp.json)
+  --claude        Configure Claude Desktop only
+  --windsurf      Configure Windsurf only
+  --cline         Configure Cline / Roo-Code only
+  --workspace     Configure current project .cursor/mcp.json
+  --dry-run       Preview configuration changes without writing files
+  --remove        Remove PrivacyScrubber from all target client configurations
+  -h, --help      Display this help guide
+`);
+    return { configured: 0 };
+  }
+
+  console.log('--------------------------------------------------');
+  console.log('PrivacyScrubber MCP Universal Auto-Configurator');
+  console.log('Zero-Trust Data Sanitization (ZTDS) for AI IDEs');
+  console.log('--------------------------------------------------\n');
+
+  if (options.dryRun) {
+    console.log('[DRY-RUN MODE] No files will be modified on disk.\n');
+  }
+  if (options.remove) {
+    console.log('[UNINSTALL MODE] Removing PrivacyScrubber MCP server from configs.\n');
+  }
+
+  const targets = getSupportedTargets();
+  let configuredCount = 0;
+  let detectedClients = 0;
+
+  for (const target of targets) {
+    const isFiltered = options.targets.length > 0 && !options.targets.includes(target.id);
+    if (isFiltered) continue;
+
+    const fileExists = fs.existsSync(target.path);
+    const parentDirExists = fs.existsSync(path.dirname(target.path));
+    const shouldProcess = fileExists || target.autoCreate || (options.all && parentDirExists);
+
+    if (!shouldProcess && !options.targets.includes(target.id)) {
+      continue;
+    }
+
+    detectedClients++;
+    console.log(`[TARGET] ${target.name}`);
+    console.log(`         Path: ${target.path}`);
+
+    const result = safeMergeMcpConfig(target.path, MCP_CONFIG_SNIPPET, options.remove);
+
+    if (!result.success) {
+      console.log(`         [ERROR]: ${result.error}\n`);
+      continue;
+    }
+
+    if (result.modified === false) {
+      console.log(`         [SKIP]: ${result.message}\n`);
+      continue;
+    }
+
+    if (!options.dryRun) {
+      try {
+        const dir = path.dirname(target.path);
+        if (!fs.existsSync(dir)) {
+          fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(target.path, result.updatedJson, 'utf8');
+        console.log(`         [OK]: Successfully ${options.remove ? 'removed from' : 'written to'} config (${result.serverCount} total MCP servers).`);
+        configuredCount++;
+      } catch (err) {
+        console.log(`         [ERROR]: Failed to write file: ${err.message}`);
+      }
+    } else {
+      console.log(`         [DRY-RUN OK]: Would write valid configuration (${result.serverCount} servers).`);
+      configuredCount++;
+    }
+    console.log('');
+  }
+
+  console.log('--------------------------------------------------');
+  if (configuredCount > 0) {
+    console.log(`[SUMMARY] ${options.remove ? 'Cleaned' : 'Configured'} ${configuredCount} AI client(s) successfully.`);
+    if (!options.remove) {
+      console.log('Next step: Restart your AI IDE or Claude Desktop to activate PrivacyScrubber.');
+    }
+  } else {
+    console.log('[SUMMARY] No active client configurations were modified.');
+    console.log('Tip: Run with --all or specify client directly (--cursor, --claude, --windsurf).');
+  }
+  console.log('--------------------------------------------------\n');
+
+  return { configured: configuredCount, detected: detectedClients };
+}
+
+// Auto-run when executed as entry script
+const isMain = process.argv[1] && (
+  path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url)) ||
+  process.argv[1].endsWith('install.js') ||
+  process.argv[1].endsWith('privacyscrubber-mcp-install')
+);
+
+if (isMain) {
+  runInstaller().catch(err => {
+    console.error('Fatal installer error:', err);
+    process.exit(1);
+  });
+}

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.3",
   "name": "privacyscrubber/pii-masking-mcp",
-  "version": "2.2.2",
+  "version": "2.2.4",
   "description": "CISO-Approved Zero-Trust PII & Secrets Redaction MCP Server for Cursor, Windsurf, and Claude Desktop. Prevent API leaks and comply with HIPAA/SOC 2 locally.",
   "author": {
     "name": "PrivacyScrubber",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@privacyscrubber/mcp-server",
-  "version": "2.2.2",
+  "version": "2.2.5",
   "mcpName": "io.github.moxno/privacyscrubber-mcp",
   "description": "CISO-Approved Zero-Trust PII & Secrets Redaction MCP Server for Cursor, Windsurf, and Claude Desktop. Prevent API leaks and comply with HIPAA/SOC 2 locally.",
   "main": "index.js",
@@ -27,6 +27,7 @@
   "bin": {
     "mcp-server": "index.js",
     "privacyscrubber-mcp": "index.js",
+    "ps-mcp": "index.js",
     "pii-masking-run": "pii-masking-run.js",
     "ps-guard": "pii-masking-run.js",
     "agentic-guard": "pii-masking-run.js",
@@ -34,8 +35,9 @@
   },
   "scripts": {
     "start": "node index.js",
-    "build": "echo 'No build step required for vanilla JS'",
-    "test": "node test-mcp.js && node test-mcp-deep.js"
+    "build": "node ../scripts/build-mcp.js",
+    "test": "node test-mcp.js && node test-mcp-deep.js",
+    "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -64,10 +66,13 @@
     "hipaa",
     "soc2",
     "grc",
-    "ciso"
+    "ciso",
+    "presidio",
+    "presidio-alternative",
+    "langchain"
   ],
   "author": "Ilya Sibiryakov (BrandMeWeb)",
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE.md",
   "homepage": "https://privacyscrubber.com/pii-mcp/?utm_source=npm&utm_medium=readme&utm_campaign=mcp_server",
   "repository": {
     "type": "git",

package/pii-masking-run.js

@@ -27,7 +27,7 @@ const cmdIndex = args.indexOf("--");
 
 if (args.includes("--version") || args.includes("-v")) {
   const pkgPath = path.resolve(__dirname, './package.json');
-  let version = '2.2.2';
+  let version = '2.2.4';
   try { version = JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version; } catch (_) {}
   console.log(`ps-guard / pii-masking-run v${version} (PrivacyScrubber MCP)`);
   process.exit(0);