@pilat/mcp-datalink 1.0.1

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,wBAAwB;IACxB,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;IAE9B,kBAAkB;IAClB,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,kBAAkB,EAAE,oBAAoB;IAExC,uBAAuB;IACvB,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAEhC,gBAAgB;IAChB,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAIX,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnB,IAAI,CAAgB;IACpB,OAAO,CAA2B;IAElD,YAAY,IAAmB,EAAE,OAAe,EAAE,OAAiC;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,oCAAoC;QACpC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/utils/formatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Formatting utilities for query results
+ */
+/**
+ * Format a single value for display
+ * Handles null, dates, objects, and primitive values
+ */
+export declare function formatValue(value: unknown): string;
+/**
+ * Format query results as a Markdown table
+ */
+export declare function formatAsMarkdownTable(columns: string[], rows: (string | null)[][]): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/utils/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsBlD;AASD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,GACxB,MAAM,CAyBR"}

package/dist/utils/formatter.js

@@ -0,0 +1,56 @@
+/**
+ * Formatting utilities for query results
+ */
+/**
+ * Format a single value for display
+ * Handles null, dates, objects, and primitive values
+ */
+export function formatValue(value) {
+    if (value === null || value === undefined) {
+        return 'NULL';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === 'object') {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+/**
+ * Escape pipe characters in cell content for Markdown tables
+ */
+function escapeForMarkdown(value) {
+    return value.replace(/\|/g, '\\|');
+}
+/**
+ * Format query results as a Markdown table
+ */
+export function formatAsMarkdownTable(columns, rows) {
+    if (columns.length === 0) {
+        return '';
+    }
+    const lines = [];
+    // Header row
+    const headerCells = columns.map((col) => escapeForMarkdown(col));
+    lines.push('| ' + headerCells.join(' | ') + ' |');
+    // Alignment row
+    const alignmentCells = columns.map(() => '---');
+    lines.push('| ' + alignmentCells.join(' | ') + ' |');
+    // Data rows
+    for (const row of rows) {
+        const cells = row.map((cell) => {
+            const value = cell === null ? 'NULL' : cell;
+            return escapeForMarkdown(value);
+        });
+        lines.push('| ' + cells.join(' | ') + ' |');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=formatter.js.map

package/dist/utils/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAiB,EACjB,IAAyB;IAEzB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,aAAa;IACb,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAElD,gBAAgB;IAChB,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAErD,YAAY;IACZ,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5C,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/utils/truncate.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Truncation utilities for limiting MCP response sizes
+ */
+export interface TruncationInfo {
+    truncated: boolean;
+    truncationReason?: 'maxRows' | 'maxCellLength' | 'maxTotalSize' | 'maxColumns';
+    totalAvailable?: number;
+    returned?: number;
+    hint?: string;
+}
+/**
+ * Truncate array of rows to maxRows limit
+ */
+export declare function truncateRows(rows: unknown[][], maxRows: number, totalAvailable?: number): {
+    rows: unknown[][];
+    info: TruncationInfo;
+};
+/**
+ * Truncate individual cell value to maxLength
+ */
+export declare function truncateCell(value: unknown, maxLength: number): {
+    value: string;
+    truncated: boolean;
+    originalLength?: number;
+};
+/**
+ * Truncate columns array to maxColumns limit
+ */
+export declare function truncateColumns(columns: string[], maxColumns: number): {
+    columns: string[];
+    truncated: boolean;
+};
+/**
+ * Check if total response size exceeds maxSize
+ */
+export declare function checkTotalSize(data: string, maxSize: number): TruncationInfo;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/utils/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/utils/truncate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,SAAS,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,CAAC;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EAAE,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB;IAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAoB7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CA8BhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAY3C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,cAAc,CAYhB"}

package/dist/utils/truncate.js

@@ -0,0 +1,91 @@
+/**
+ * Truncation utilities for limiting MCP response sizes
+ */
+/**
+ * Truncate array of rows to maxRows limit
+ */
+export function truncateRows(rows, maxRows, totalAvailable) {
+    const available = totalAvailable ?? rows.length;
+    if (rows.length <= maxRows) {
+        return {
+            rows,
+            info: { truncated: false },
+        };
+    }
+    return {
+        rows: rows.slice(0, maxRows),
+        info: {
+            truncated: true,
+            truncationReason: 'maxRows',
+            totalAvailable: available,
+            returned: maxRows,
+            hint: 'Use LIMIT/OFFSET or WHERE clause to paginate',
+        },
+    };
+}
+/**
+ * Truncate individual cell value to maxLength
+ */
+export function truncateCell(value, maxLength) {
+    // Convert value to string
+    let stringValue;
+    if (value === null || value === undefined) {
+        stringValue = 'NULL';
+    }
+    else if (typeof value === 'string') {
+        stringValue = value;
+    }
+    else if (typeof value === 'number' || typeof value === 'boolean') {
+        stringValue = String(value);
+    }
+    else if (value instanceof Date) {
+        stringValue = value.toISOString();
+    }
+    else if (typeof value === 'object') {
+        stringValue = JSON.stringify(value);
+    }
+    else {
+        stringValue = String(value);
+    }
+    if (stringValue.length <= maxLength) {
+        return {
+            value: stringValue,
+            truncated: false,
+        };
+    }
+    return {
+        value: stringValue.slice(0, maxLength) + '...',
+        truncated: true,
+        originalLength: stringValue.length,
+    };
+}
+/**
+ * Truncate columns array to maxColumns limit
+ */
+export function truncateColumns(columns, maxColumns) {
+    if (columns.length <= maxColumns) {
+        return {
+            columns,
+            truncated: false,
+        };
+    }
+    return {
+        columns: columns.slice(0, maxColumns),
+        truncated: true,
+    };
+}
+/**
+ * Check if total response size exceeds maxSize
+ */
+export function checkTotalSize(data, maxSize) {
+    const byteLength = Buffer.byteLength(data, 'utf8');
+    if (byteLength <= maxSize) {
+        return { truncated: false };
+    }
+    return {
+        truncated: true,
+        truncationReason: 'maxTotalSize',
+        hint: 'Use LIMIT/OFFSET or WHERE clause to paginate',
+    };
+}
+//# sourceMappingURL=truncate.js.map

package/dist/utils/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../src/utils/truncate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAiB,EACjB,OAAe,EACf,cAAuB;IAEvB,MAAM,SAAS,GAAG,cAAc,IAAI,IAAI,CAAC,MAAM,CAAC;IAEhD,IAAI,IAAI,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;SAC3B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;QAC5B,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI;YACf,gBAAgB,EAAE,SAAS;YAC3B,cAAc,EAAE,SAAS;YACzB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,8CAA8C;SACrD;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAc,EACd,SAAiB;IAEjB,0BAA0B;IAC1B,IAAI,WAAmB,CAAC;IAExB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,WAAW,GAAG,MAAM,CAAC;IACvB,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,WAAW,GAAG,KAAK,CAAC;IACtB,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACnE,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;SAAM,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QACjC,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACpC,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,KAAK;QAC9C,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,WAAW,CAAC,MAAM;KACnC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAiB,EACjB,UAAkB;IAElB,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QACjC,OAAO;YACL,OAAO;YACP,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;QACrC,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAe;IAEf,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,UAAU,IAAI,OAAO,EAAE,CAAC;QAC1B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI;QACf,gBAAgB,EAAE,cAAc;QAChC,IAAI,EAAE,8CAA8C;KACrD,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@pilat/mcp-datalink",
+  "version": "1.0.1",
+  "description": "MCP server for secure database access (PostgreSQL, MySQL, SQLite)",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-datalink": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "test:unit": "vitest --run --exclude 'src/__integration__/**'",
+    "test:integration": "vitest run --config vitest.config.integration.ts",
+    "test:integration:watch": "vitest --config vitest.config.integration.ts",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "database",
+    "postgresql",
+    "mysql",
+    "sqlite",
+    "claude",
+    "claude-code",
+    "model-context-protocol"
+  ],
+  "author": "pilat",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pilat/mcp-datalink"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "databases.example.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.7.0",
+    "mysql2": "^3.6.0",
+    "pg": "^8.11.0",
+    "pgsql-ast-parser": "^12.0.0"
+  },
+  "devDependencies": {
+    "@testcontainers/mysql": "^11.11.0",
+    "@testcontainers/postgresql": "^11.11.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.0.0",
+    "@types/pg": "^8.11.0",
+    "testcontainers": "^11.11.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  }
+}