mcp-migration-advisor 0.2.0 → 0.2.3

package/build/index.js

@@ -16,9 +16,21 @@ import { analyzeLockRisks, calculateRiskScore } from "./analyzers/lock-risk.js";
 import { analyzeDataLoss } from "./analyzers/data-loss.js";
 import { generateRollback } from "./generators/rollback.js";
 import { detectConflicts, formatConflictReport } from "./analyzers/conflicts.js";
-import { validateLicense, formatUpgradePrompt } from "./license.js";
-// License check (reads MCP_LICENSE_KEY env var once at startup)
-const license = validateLicense(process.env.MCP_LICENSE_KEY, "migration-advisor");
+/**
+ * Format parser warnings into a markdown section.
+ * Returns empty string if there are no warnings.
+ */
+function formatParserWarnings(migration) {
+    if (migration.warnings.length === 0)
+        return "";
+    let output = "### Parser Warnings\n\n";
+    output += `> ${migration.warnings.length} DDL statement(s) could not be fully parsed and were classified as OTHER\n\n`;
+    for (const w of migration.warnings) {
+        output += `- \`${w.snippet}\`\n`;
+    }
+    output += "\n";
+    return output;
+}
 // Handle --help
 if (process.argv.includes("--help") || process.argv.includes("-h")) {
     console.log(`mcp-migration-advisor v0.1.0 — MCP server for database migration risk analysis
@@ -94,6 +106,7 @@ server.tool("analyze_migration", "Analyze a SQL migration file for lock risks, d
     else {
         output += "### Data Loss Analysis\n\nNo data loss risks detected.\n\n";
     }
+    output += formatParserWarnings(migration);
     return {
         content: [{ type: "text", text: output }],
     };
@@ -134,6 +147,7 @@ server.tool("analyze_liquibase", "Analyze a Liquibase XML changelog for lock ris
     if (lockRisks.length === 0 && dataLossIssues.length === 0) {
         output += "### No risks detected.\n";
     }
+    output += formatParserWarnings(migration);
     return { content: [{ type: "text", text: output }] };
 });
 // Tool 3: analyze_liquibase_yaml
@@ -172,6 +186,7 @@ server.tool("analyze_liquibase_yaml", "Analyze a Liquibase YAML changelog for lo
     if (lockRisks.length === 0 && dataLossIssues.length === 0) {
         output += "### No risks detected.\n";
     }
+    output += formatParserWarnings(migration);
     return { content: [{ type: "text", text: output }] };
 });
 // Tool 4: score_risk
@@ -220,21 +235,6 @@ server.tool("generate_rollback", "Generate reverse DDL to undo a SQL migration.
     filename: z.string().describe("Migration filename (e.g., V2__add_user_email.sql)"),
     sql: z.string().describe("The SQL content of the migration file"),
 }, async ({ filename, sql }) => {
-    // Pro feature gate — free users get a preview, Pro users get full output
-    if (!license.isPro) {
-        const migration = parseMigration(filename, sql);
-        const report = generateRollback(migration);
-        // Show a preview: statement count and reversibility, but not the actual SQL
-        let preview = `## Rollback Preview: ${filename}\n\n`;
-        preview += `**Reversible**: ${report.fullyReversible ? "Yes" : "Partially"}\n`;
-        preview += `**Statements**: ${report.statements.length}\n`;
-        preview += `**Warnings**: ${report.warnings.length}\n\n`;
-        preview += formatUpgradePrompt("generate_rollback", "Full rollback SQL generation with:\n" +
-            "- Complete reverse DDL for all migration operations\n" +
-            "- Flyway schema_history cleanup statements\n" +
-            "- Irreversibility warnings with manual intervention guidance");
-        return { content: [{ type: "text", text: preview }] };
-    }
     const migration = parseMigration(filename, sql);
     const report = generateRollback(migration);
     let output = `## Rollback Script: ${filename}\n\n`;

package/build/parsers/flyway-sql.js

@@ -171,6 +171,30 @@ function classifyStatement(raw) {
     }
     return { type: "OTHER", raw, tableName: null, columnName: null, details };
 }
+/**
+ * Build a snippet of up to ~80 characters from a raw statement for debugging.
+ */
+export function truncateSnippet(raw, maxLen = 80) {
+    const oneLine = raw.replace(/\s+/g, " ").trim();
+    if (oneLine.length <= maxLen)
+        return oneLine;
+    return oneLine.substring(0, maxLen) + "...";
+}
+/**
+ * Collect warnings for statements classified as OTHER.
+ */
+export function collectParserWarnings(statements) {
+    const warnings = [];
+    for (const stmt of statements) {
+        if (stmt.type === "OTHER") {
+            warnings.push({
+                message: "Unrecognized DDL statement classified as OTHER",
+                snippet: truncateSnippet(stmt.raw),
+            });
+        }
+    }
+    return warnings;
+}
 /**
  * Parse a complete Flyway migration file.
  */
@@ -178,12 +202,14 @@ export function parseMigration(filename, sql) {
     const { version, description, isRepeatable } = parseFlywayFilename(filename);
     const rawStatements = splitStatements(sql);
     const statements = rawStatements.map(classifyStatement);
+    const warnings = collectParserWarnings(statements);
     return {
         version,
         description,
         filename,
         isRepeatable,
         statements,
+        warnings,
     };
 }
 //# sourceMappingURL=flyway-sql.js.map

package/build/parsers/liquibase-xml.js

@@ -4,6 +4,7 @@
  * Parses Liquibase XML changelogs and extracts DDL operations
  * compatible with the same DDLStatement interface used by Flyway.
  */
+import { collectParserWarnings } from "./flyway-sql.js";
 /**
  * Parse a Liquibase XML changelog and extract DDL statements.
  *
@@ -23,6 +24,7 @@ export function parseLiquibaseXml(xml) {
         filename: "changelog.xml",
         isRepeatable: false,
         statements: allStatements,
+        warnings: collectParserWarnings(allStatements),
     };
 }
 function extractChangeSets(xml) {

package/build/parsers/liquibase-yaml.js

@@ -4,6 +4,7 @@
  * Parses Liquibase YAML changelogs and extracts DDL operations
  * compatible with the same DDLStatement interface used by Flyway and XML.
  */
+import { collectParserWarnings } from "./flyway-sql.js";
 /**
  * Parse a Liquibase YAML changelog and extract DDL statements.
  *
@@ -23,6 +24,7 @@ export function parseLiquibaseYaml(yaml) {
         filename: "changelog.yaml",
         isRepeatable: false,
         statements: allStatements,
+        warnings: collectParserWarnings(allStatements),
     };
 }
 function extractChangeSets(yaml) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-migration-advisor",
-  "version": "0.2.0",
+  "version": "0.2.3",
   "description": "MCP server for database migration risk analysis — Flyway and Liquibase XML/YAML/SQL support with lock detection and conflict analysis",
   "main": "build/index.js",
   "bin": {
@@ -20,17 +20,21 @@
   ],
   "keywords": [
     "mcp",
+    "mcp-server",
     "model-context-protocol",
-    "database",
+    "ai",
+    "claude",
+    "anthropic",
     "migration",
+    "database-migration",
+    "schema-migration",
+    "database",
     "flyway",
     "liquibase",
     "schema",
     "risk-analysis",
     "postgresql",
-    "mysql",
-    "ai",
-    "claude"
+    "mysql"
   ],
   "author": "Dmytro Lisnichenko",
   "license": "MIT",

package/build/license.js

@@ -1,115 +0,0 @@
-/**
- * License validation for MCP Migration Advisor (Pro features).
- *
- * Validates license keys offline using HMAC-SHA256.
- * Missing or invalid keys gracefully degrade to free mode — never errors.
- *
- * Key format: MCPJBS-XXXXX-XXXXX-XXXXX-XXXXX
- * Payload (12 bytes = 20 base32 chars):
- *   [0]     product mask (8 bits)
- *   [1-2]   expiry days since 2026-01-01 (16 bits)
- *   [3-5]   customer ID (24 bits)
- *   [6-11]  HMAC-SHA256 truncated (48 bits)
- */
-import { createHmac } from "node:crypto";
-const KEY_PREFIX = "MCPJBS-";
-const EPOCH = new Date("2026-01-01T00:00:00Z");
-const BASE32_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
-const HMAC_SECRET = "mcp-java-backend-suite-license-v1";
-const PRODUCTS = {
-    "db-analyzer": 0,
-    "jvm-diagnostics": 1,
-    "migration-advisor": 2,
-    "spring-boot-actuator": 3,
-    "redis-diagnostics": 4,
-};
-export function validateLicense(key, product) {
-    const FREE = {
-        isPro: false,
-        expiresAt: null,
-        customerId: null,
-        reason: "No license key provided",
-    };
-    if (!key || key.trim().length === 0)
-        return FREE;
-    const trimmed = key.trim().toUpperCase();
-    if (!trimmed.startsWith(KEY_PREFIX)) {
-        return { ...FREE, reason: "Invalid key format: missing MCPJBS- prefix" };
-    }
-    const body = trimmed.slice(KEY_PREFIX.length).replace(/-/g, "");
-    if (body.length < 20) {
-        return { ...FREE, reason: "Invalid key format: too short" };
-    }
-    let decoded;
-    try {
-        decoded = base32Decode(body.slice(0, 20));
-    }
-    catch {
-        return { ...FREE, reason: "Invalid key format: bad base32 encoding" };
-    }
-    if (decoded.length < 12) {
-        return { ...FREE, reason: "Invalid key format: decoded data too short" };
-    }
-    const payload = decoded.subarray(0, 6);
-    const providedSignature = decoded.subarray(6, 12);
-    const expectedHmac = createHmac("sha256", HMAC_SECRET)
-        .update(payload)
-        .digest();
-    const expectedSignature = expectedHmac.subarray(0, 6);
-    if (!providedSignature.equals(expectedSignature)) {
-        return { ...FREE, reason: "Invalid license key: signature mismatch" };
-    }
-    const productMask = payload[0];
-    const daysSinceEpoch = (payload[1] << 8) | payload[2];
-    const customerId = (payload[3] << 16) | (payload[4] << 8) | payload[5];
-    const productBit = PRODUCTS[product];
-    if (productBit === undefined) {
-        return { ...FREE, reason: `Unknown product: ${product}` };
-    }
-    if ((productMask & (1 << productBit)) === 0) {
-        return { ...FREE, customerId, reason: `License does not include ${product}` };
-    }
-    const expiresAt = new Date(EPOCH.getTime() + daysSinceEpoch * 24 * 60 * 60 * 1000);
-    if (new Date() > expiresAt) {
-        return {
-            isPro: false,
-            expiresAt,
-            customerId,
-            reason: `License expired on ${expiresAt.toISOString().slice(0, 10)}`,
-        };
-    }
-    return { isPro: true, expiresAt, customerId, reason: "Valid Pro license" };
-}
-export function formatUpgradePrompt(toolName, featureDescription) {
-    return [
-        `## ${toolName} (Pro Feature)`,
-        "",
-        "This analysis is available with MCP Java Backend Suite Pro.",
-        "",
-        `**What you'll get:**`,
-        featureDescription,
-        "",
-        "**Upgrade**: https://mcpjbs.dev/pricing",
-        "**Price**: $19/month or $190/year",
-        "",
-        "> Already have a key? Set `MCP_LICENSE_KEY` in your Claude Desktop config.",
-    ].join("\n");
-}
-function base32Decode(encoded) {
-    const bytes = [];
-    let bits = 0;
-    let value = 0;
-    for (const char of encoded) {
-        const idx = BASE32_CHARS.indexOf(char);
-        if (idx === -1)
-            throw new Error(`Invalid base32 character: ${char}`);
-        value = (value << 5) | idx;
-        bits += 5;
-        if (bits >= 8) {
-            bits -= 8;
-            bytes.push((value >> bits) & 0xff);
-        }
-    }
-    return Buffer.from(bytes);
-}
-//# sourceMappingURL=license.js.map