@pilat/mcp-datalink 1.0.1

package/dist/tools/execute.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Execute tool for INSERT/UPDATE/DELETE statements
+ */
+import type { Config, ExecuteResult } from '../types.js';
+export interface ExecuteParams {
+    database: string;
+    sql: string;
+    params?: unknown[];
+}
+/**
+ * Execute an INSERT/UPDATE/DELETE statement
+ *
+ * @param params - Execute parameters including database name, SQL, and optional params
+ * @param config - Application configuration
+ * @returns ExecuteResult with command type and rows affected
+ * @throws DbMcpError with READONLY_VIOLATION if database is readonly
+ * @throws DbMcpError with QUERY_BLOCKED if SELECT or dangerous DDL
+ * @throws DbMcpError with DATABASE_NOT_FOUND if database not configured
+ * @throws DbMcpError with CONNECTION_FAILED if connection fails
+ */
+export declare function execute(params: ExecuteParams, config: Config): Promise<ExecuteResult>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/tools/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/tools/execute.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CA+CxB"}

package/dist/tools/execute.js

@@ -0,0 +1,48 @@
+/**
+ * Execute tool for INSERT/UPDATE/DELETE statements
+ */
+import { createAdapter } from '../adapters/index.js';
+import { DbMcpError, ErrorCode } from '../utils/errors.js';
+/**
+ * Execute an INSERT/UPDATE/DELETE statement
+ *
+ * @param params - Execute parameters including database name, SQL, and optional params
+ * @param config - Application configuration
+ * @returns ExecuteResult with command type and rows affected
+ * @throws DbMcpError with READONLY_VIOLATION if database is readonly
+ * @throws DbMcpError with QUERY_BLOCKED if SELECT or dangerous DDL
+ * @throws DbMcpError with DATABASE_NOT_FOUND if database not configured
+ * @throws DbMcpError with CONNECTION_FAILED if connection fails
+ */
+export async function execute(params, config) {
+    const startTime = Date.now();
+    // Get database config
+    const dbConfig = config.databases[params.database];
+    if (!dbConfig) {
+        throw new DbMcpError(ErrorCode.DATABASE_NOT_FOUND, `Database "${params.database}" not found in configuration`, { database: params.database, available: Object.keys(config.databases) });
+    }
+    // Step 1: Check if database is readonly
+    if (dbConfig.readonly) {
+        throw new DbMcpError(ErrorCode.READONLY_VIOLATION, `Database "${params.database}" is configured as readonly. INSERT/UPDATE/DELETE operations are not allowed.`, { database: params.database });
+    }
+    // Create adapter for this database
+    const adapter = createAdapter(dbConfig, config.defaults);
+    // Step 2: Validate query type - blocks SELECT and dangerous DDL
+    adapter.validateQueryForTool(params.sql, 'execute');
+    // Step 3: Get the command type from parsed query
+    const parsed = adapter.parseQuery(params.sql);
+    const command = parsed.type.toUpperCase();
+    // Step 4: Convert placeholders for non-PostgreSQL dialects
+    // PostgreSQL uses $1, $2; MySQL/SQLite use ?
+    const sql = adapter.convertPlaceholders(params.sql);
+    const result = await adapter.withConnection(async (conn) => {
+        return conn.query(sql, params.params ?? []);
+    });
+    const executionTime = Date.now() - startTime;
+    return {
+        command,
+        rowsAffected: result.rowCount,
+        executionTime,
+    };
+}
+//# sourceMappingURL=execute.js.map

package/dist/tools/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/tools/execute.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQ3D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAqB,EACrB,MAAc;IAEd,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,sBAAsB;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,kBAAkB,EAC5B,aAAa,MAAM,CAAC,QAAQ,8BAA8B,EAC1D,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,kBAAkB,EAC5B,aAAa,MAAM,CAAC,QAAQ,+EAA+E,EAC3G,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAC9B,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEzD,gEAAgE;IAChE,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAEpD,iDAAiD;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAE1C,2DAA2D;IAC3D,6CAA6C;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAE7C,OAAO;QACL,OAAO;QACP,YAAY,EAAE,MAAM,CAAC,QAAQ;QAC7B,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/tools/explain.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Explain tool for showing query execution plans
+ */
+import type { Config } from '../types.js';
+export interface ExplainParams {
+    database: string;
+    sql: string;
+    analyze?: boolean;
+}
+export interface ExplainResult {
+    plan: string;
+    executionTime: number;
+}
+/**
+ * Get the execution plan for a SQL query
+ *
+ * @param params - Explain parameters including database name, SQL, and optional analyze flag
+ * @param config - Application configuration
+ * @returns ExplainResult with plan text and execution time
+ * @throws DbMcpError with QUERY_BLOCKED if query is dangerous (DROP, TRUNCATE, etc.)
+ * @throws DbMcpError with DATABASE_NOT_FOUND if database not configured
+ * @throws DbMcpError with CONNECTION_FAILED if connection fails
+ */
+export declare function explain(params: ExplainParams, config: Config): Promise<ExplainResult>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/tools/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/tools/explain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAmFxB"}

package/dist/tools/explain.js

@@ -0,0 +1,81 @@
+/**
+ * Explain tool for showing query execution plans
+ */
+import { createAdapter } from '../adapters/index.js';
+import { DbMcpError, ErrorCode } from '../utils/errors.js';
+/**
+ * Get the execution plan for a SQL query
+ *
+ * @param params - Explain parameters including database name, SQL, and optional analyze flag
+ * @param config - Application configuration
+ * @returns ExplainResult with plan text and execution time
+ * @throws DbMcpError with QUERY_BLOCKED if query is dangerous (DROP, TRUNCATE, etc.)
+ * @throws DbMcpError with DATABASE_NOT_FOUND if database not configured
+ * @throws DbMcpError with CONNECTION_FAILED if connection fails
+ */
+export async function explain(params, config) {
+    const startTime = Date.now();
+    // Get database config
+    const dbConfig = config.databases[params.database];
+    if (!dbConfig) {
+        throw new DbMcpError(ErrorCode.DATABASE_NOT_FOUND, `Database "${params.database}" not found in configuration`, { database: params.database, available: Object.keys(config.databases) });
+    }
+    // Create adapter for this database
+    const adapter = createAdapter(dbConfig, config.defaults);
+    // Step 1: Parse query and check for dangerous operations
+    const parsed = adapter.parseQuery(params.sql);
+    if (parsed.isDangerous) {
+        throw new DbMcpError(ErrorCode.QUERY_BLOCKED, parsed.dangerousReason ?? 'This operation is not allowed', { sql: params.sql, queryType: parsed.type });
+    }
+    const result = await adapter.withConnection(async (conn) => {
+        // Build EXPLAIN query using adapter-specific prefix
+        const explainPrefix = adapter.getExplainPrefix(params.analyze ?? false);
+        // SQLite and MySQL don't need READ ONLY transactions for EXPLAIN:
+        // - SQLite: Doesn't support READ ONLY transactions
+        // - MySQL: EXPLAIN doesn't execute the query, and READ ONLY tx blocks
+        //   EXPLAIN on UPDATE/DELETE even though they're safe
+        //
+        // Defense in depth is still provided by:
+        // 1. SQL parser blocking dangerous operations (DROP, TRUNCATE, etc.)
+        // 2. EXPLAIN not executing the query (MySQL) / EXPLAIN QUERY PLAN (SQLite)
+        // 3. Database adapter opening in readonly mode when configured
+        if (adapter.type === 'sqlite' || adapter.type === 'mysql') {
+            return await conn.query(explainPrefix + params.sql);
+        }
+        // PostgreSQL: Use READ ONLY transaction since EXPLAIN ANALYZE executes the query
+        await conn.execute('BEGIN TRANSACTION READ ONLY');
+        try {
+            const queryResult = await conn.query(explainPrefix + params.sql);
+            await conn.execute('COMMIT');
+            return queryResult;
+        }
+        catch (error) {
+            await conn.execute('ROLLBACK');
+            throw error;
+        }
+    });
+    // Step 3: Format plan as text (join rows with newlines)
+    // Different databases have different EXPLAIN output formats:
+    // - PostgreSQL: Single column with plan text
+    // - MySQL: Multiple columns (id, select_type, table, type, key, rows, Extra, etc.)
+    // - SQLite: 4 columns (id, parent, notused, detail)
+    const planLines = result.rows.map((row) => {
+        if (adapter.type === 'sqlite' && row.length >= 4) {
+            // SQLite: extract the 'detail' column (4th column, index 3)
+            return String(row[3]);
+        }
+        if (adapter.type === 'mysql' && row.length > 1) {
+            // MySQL: Join all columns with tabs for tabular output
+            // Columns: id, select_type, table, partitions, type, possible_keys, key, key_len, ref, rows, filtered, Extra
+            return row.map((col) => (col === null ? 'NULL' : String(col))).join('\t');
+        }
+        // PostgreSQL: first column is the plan line
+        return row[0];
+    });
+    const executionTime = Date.now() - startTime;
+    return {
+        plan: planLines.join('\n'),
+        executionTime,
+    };
+}
+//# sourceMappingURL=explain.js.map

package/dist/tools/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/tools/explain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAa3D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAqB,EACrB,MAAc;IAEd,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,sBAAsB;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,kBAAkB,EAC5B,aAAa,MAAM,CAAC,QAAQ,8BAA8B,EAC1D,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEzD,yDAAyD;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,aAAa,EACvB,MAAM,CAAC,eAAe,IAAI,+BAA+B,EACzD,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,CAC5C,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACzD,oDAAoD;QACpD,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;QAExE,kEAAkE;QAClE,mDAAmD;QACnD,sEAAsE;QACtE,sDAAsD;QACtD,EAAE;QACF,yCAAyC;QACzC,qEAAqE;QACrE,2EAA2E;QAC3E,+DAA+D;QAC/D,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1D,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtD,CAAC;QAED,iFAAiF;QACjF,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QAElD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAEjE,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC7B,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC/B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,wDAAwD;IACxD,6DAA6D;IAC7D,6CAA6C;IAC7C,mFAAmF;IACnF,oDAAoD;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACxC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACjD,4DAA4D;YAC5D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,uDAAuD;YACvD,6GAA6G;YAC7G,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,CAAC;QACD,4CAA4C;QAC5C,OAAO,GAAG,CAAC,CAAC,CAAW,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAE7C,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1B,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/tools/list-databases.d.ts

@@ -0,0 +1,18 @@
+/**
+ * list_databases tool - returns configured databases from config
+ */
+import type { Config } from '../types.js';
+export interface ListDatabasesResult {
+    databases: Array<{
+        name: string;
+        readonly: boolean;
+    }>;
+}
+/**
+ * Returns all configured databases with their readonly flags.
+ *
+ * @param config - The application config containing database configurations
+ * @returns List of databases with name and readonly status
+ */
+export declare function listDatabases(config: Config): ListDatabasesResult;
+//# sourceMappingURL=list-databases.d.ts.map

package/dist/tools/list-databases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-databases.d.ts","sourceRoot":"","sources":["../../src/tools/list-databases.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAOjE"}

package/dist/tools/list-databases.js

@@ -0,0 +1,17 @@
+/**
+ * list_databases tool - returns configured databases from config
+ */
+/**
+ * Returns all configured databases with their readonly flags.
+ *
+ * @param config - The application config containing database configurations
+ * @returns List of databases with name and readonly status
+ */
+export function listDatabases(config) {
+    const databases = Object.entries(config.databases).map(([name, dbConfig]) => ({
+        name,
+        readonly: dbConfig.readonly,
+    }));
+    return { databases };
+}
+//# sourceMappingURL=list-databases.js.map

package/dist/tools/list-databases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-databases.js","sourceRoot":"","sources":["../../src/tools/list-databases.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5E,IAAI;QACJ,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}

package/dist/tools/list-tables.d.ts

@@ -0,0 +1,22 @@
+/**
+ * list_tables tool - lists tables in a database schema
+ */
+import type { Config, TableInfo } from '../types.js';
+export interface ListTablesParams {
+    database: string;
+    schema?: string;
+}
+export interface ListTablesResult {
+    tables: TableInfo[];
+    truncated: boolean;
+    totalAvailable?: number;
+}
+/**
+ * Lists tables and views in a database schema.
+ *
+ * @param params - Database name and optional schema (defaults to "public")
+ * @param config - The application config
+ * @returns List of tables with truncation info if over maxTables limit
+ */
+export declare function listTables(params: ListTablesParams, config: Config): Promise<ListTablesResult>;
+//# sourceMappingURL=list-tables.d.ts.map

package/dist/tools/list-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tables.d.ts","sourceRoot":"","sources":["../../src/tools/list-tables.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIrD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CAuC3B"}

package/dist/tools/list-tables.js

@@ -0,0 +1,43 @@
+/**
+ * list_tables tool - lists tables in a database schema
+ */
+import { createAdapter } from '../adapters/index.js';
+import { DbMcpError, ErrorCode } from '../utils/errors.js';
+/**
+ * Lists tables and views in a database schema.
+ *
+ * @param params - Database name and optional schema (defaults to "public")
+ * @param config - The application config
+ * @returns List of tables with truncation info if over maxTables limit
+ */
+export async function listTables(params, config) {
+    const maxTables = config.defaults.maxTables;
+    // Get database config
+    const dbConfig = config.databases[params.database];
+    if (!dbConfig) {
+        throw new DbMcpError(ErrorCode.DATABASE_NOT_FOUND, `Database "${params.database}" not found in configuration`, { database: params.database, available: Object.keys(config.databases) });
+    }
+    // Create adapter for this database
+    const adapter = createAdapter(dbConfig, config.defaults);
+    // Use provided schema or adapter's default schema
+    // PostgreSQL: "public", MySQL: database name, SQLite: "main"
+    const schema = params.schema ?? adapter.getDefaultSchema();
+    return adapter.withConnection(async (conn) => {
+        const result = await conn.listTables(schema, maxTables);
+        const allTables = result.tables;
+        const totalAvailable = result.totalAvailable;
+        const truncated = totalAvailable > maxTables;
+        if (truncated) {
+            return {
+                tables: allTables.slice(0, maxTables),
+                truncated: true,
+                totalAvailable,
+            };
+        }
+        return {
+            tables: allTables,
+            truncated: false,
+        };
+    });
+}
+//# sourceMappingURL=list-tables.js.map

package/dist/tools/list-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tables.js","sourceRoot":"","sources":["../../src/tools/list-tables.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAa3D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAwB,EACxB,MAAc;IAEd,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;IAE5C,sBAAsB;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,kBAAkB,EAC5B,aAAa,MAAM,CAAC,QAAQ,8BAA8B,EAC1D,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEzD,kDAAkD;IAClD,6DAA6D;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAE3D,OAAO,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAChC,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC7C,MAAM,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC;QAE7C,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;gBACL,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;gBACrC,SAAS,EAAE,IAAI;gBACf,cAAc;aACf,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/query.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Query tool for executing SELECT statements
+ */
+import type { Config, QueryResult } from '../types.js';
+export interface QueryParams {
+    database: string;
+    sql: string;
+    params?: unknown[];
+}
+/**
+ * Format QueryResult as Markdown table followed by metadata
+ */
+export declare function formatQueryResultAsMarkdown(result: QueryResult): string;
+/**
+ * Execute a SELECT query and return formatted results
+ *
+ * @param params - Query parameters including database name, SQL, and optional params
+ * @param config - Application configuration
+ * @returns QueryResult with columns, rows, and metadata
+ * @throws DbMcpError with QUERY_BLOCKED if not a SELECT query
+ * @throws DbMcpError with DATABASE_NOT_FOUND if database not configured
+ * @throws DbMcpError with CONNECTION_FAILED if connection fails
+ */
+export declare function query(params: QueryParams, config: Config): Promise<QueryResult>;
+//# sourceMappingURL=query.d.ts.map

package/dist/tools/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAMvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAqBvE;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,CA6FtB"}

package/dist/tools/query.js

@@ -0,0 +1,109 @@
+/**
+ * Query tool for executing SELECT statements
+ */
+import { createAdapter } from '../adapters/index.js';
+import { DbMcpError, ErrorCode } from '../utils/errors.js';
+import { truncateRows, truncateCell, checkTotalSize } from '../utils/truncate.js';
+import { formatAsMarkdownTable, formatValue } from '../utils/formatter.js';
+/**
+ * Format QueryResult as Markdown table followed by metadata
+ */
+export function formatQueryResultAsMarkdown(result) {
+    const parts = [];
+    // Data as Markdown table
+    const table = formatAsMarkdownTable(result.columns, result.rows);
+    if (table) {
+        parts.push(table);
+    }
+    else {
+        parts.push('_No results_');
+    }
+    // Metadata section
+    parts.push('');
+    parts.push(`**Rows:** ${result.rowCount}${result.truncated ? ` (truncated from ${result.totalAvailable ?? 'unknown'})` : ''}`);
+    parts.push(`**Execution time:** ${result.executionTime}ms`);
+    if (result.truncated && result.hint) {
+        parts.push(`**Hint:** ${result.hint}`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Execute a SELECT query and return formatted results
+ *
+ * @param params - Query parameters including database name, SQL, and optional params
+ * @param config - Application configuration
+ * @returns QueryResult with columns, rows, and metadata
+ * @throws DbMcpError with QUERY_BLOCKED if not a SELECT query
+ * @throws DbMcpError with DATABASE_NOT_FOUND if database not configured
+ * @throws DbMcpError with CONNECTION_FAILED if connection fails
+ */
+export async function query(params, config) {
+    const startTime = Date.now();
+    // Get database config
+    const dbConfig = config.databases[params.database];
+    if (!dbConfig) {
+        throw new DbMcpError(ErrorCode.DATABASE_NOT_FOUND, `Database "${params.database}" not found in configuration`, { database: params.database, available: Object.keys(config.databases) });
+    }
+    // Create adapter for this database
+    const adapter = createAdapter(dbConfig, config.defaults);
+    // Step 1: Validate that this is a SELECT query
+    adapter.validateQueryForTool(params.sql, 'query');
+    // Step 2: Parse query and inject LIMIT if missing
+    const parsed = adapter.parseQuery(params.sql);
+    let sql = params.sql;
+    if (!parsed.hasLimit) {
+        // Get maxRows from database config or defaults
+        const maxRows = dbConfig?.maxRows ?? config.defaults.maxRows;
+        sql = adapter.injectLimit(params.sql, maxRows);
+    }
+    // Step 3: Convert placeholders for non-PostgreSQL dialects
+    // PostgreSQL uses $1, $2; MySQL/SQLite use ?
+    sql = adapter.convertPlaceholders(sql);
+    const result = await adapter.withConnection(async (conn) => {
+        return conn.query(sql, params.params ?? []);
+    });
+    const columns = result.fields.map((field) => field.name);
+    const rawRows = result.rows;
+    // Step 4: Format each cell value
+    let formattedRows = rawRows.map((row) => row.map((cell) => formatValue(cell)));
+    // Step 5: Truncate individual cells if over maxCellLength
+    let anyCellTruncated = false;
+    formattedRows = formattedRows.map((row) => row.map((cell) => {
+        const truncated = truncateCell(cell, config.defaults.maxCellLength);
+        if (truncated.truncated) {
+            anyCellTruncated = true;
+        }
+        return truncated.value;
+    }));
+    // Step 6: Truncate rows if over maxRows
+    const { rows: truncatedRows, info: rowTruncationInfo } = truncateRows(formattedRows, config.defaults.maxRows);
+    // Step 7: Check total size
+    const tableOutput = formatAsMarkdownTable(columns, truncatedRows);
+    const sizeInfo = checkTotalSize(tableOutput, config.defaults.maxTotalSize);
+    // Determine final truncation state
+    const truncated = rowTruncationInfo.truncated || anyCellTruncated || sizeInfo.truncated;
+    // Determine truncation reason (priority: maxTotalSize > maxRows > maxCellLength)
+    let truncationReason;
+    if (sizeInfo.truncated) {
+        truncationReason = sizeInfo.truncationReason;
+    }
+    else if (rowTruncationInfo.truncated) {
+        truncationReason = rowTruncationInfo.truncationReason;
+    }
+    else if (anyCellTruncated) {
+        truncationReason = 'maxCellLength';
+    }
+    const executionTime = Date.now() - startTime;
+    return {
+        columns,
+        rows: truncatedRows,
+        rowCount: truncatedRows.length,
+        truncated,
+        truncationReason,
+        totalAvailable: rowTruncationInfo.totalAvailable,
+        returned: rowTruncationInfo.returned,
+        hint: rowTruncationInfo.hint ?? sizeInfo.hint,
+        executionTime,
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/tools/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Core types for db-mcp server
+ */
+export type QueryType = 'select' | 'insert' | 'update' | 'delete' | 'other';
+export interface ParsedQuery {
+    /** The type of SQL query */
+    type: QueryType;
+    /** Whether the query has a LIMIT clause (for SELECT queries) */
+    hasLimit: boolean;
+    /** Whether the query is dangerous (DROP, TRUNCATE, ALTER, etc.) */
+    isDangerous: boolean;
+    /** Reason why query is considered dangerous */
+    dangerousReason?: string;
+    /** The original SQL string */
+    sql: string;
+}
+export interface DatabaseConfig {
+    url: string;
+    readonly: boolean;
+    maxRows?: number;
+}
+export interface DefaultsConfig {
+    maxRows: number;
+    maxCellLength: number;
+    maxTotalSize: number;
+    maxColumns: number;
+    maxTables: number;
+    maxIndexes: number;
+    timeout: number;
+}
+export interface Config {
+    databases: Record<string, DatabaseConfig>;
+    defaults: DefaultsConfig;
+}
+/** Raw config shape before defaults are applied */
+export interface RawConfig {
+    databases?: Record<string, Partial<DatabaseConfig> & {
+        url: string;
+    }>;
+    defaults?: Partial<DefaultsConfig>;
+}
+export interface QueryResult {
+    columns: string[];
+    rows: unknown[][];
+    rowCount: number;
+    truncated: boolean;
+    truncationReason?: string;
+    totalAvailable?: number;
+    returned?: number;
+    hint?: string;
+    executionTime: number;
+}
+export interface ExecuteResult {
+    command: string;
+    rowsAffected: number;
+    executionTime: number;
+}
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable: boolean;
+    default: string | null;
+    primaryKey: boolean;
+}
+export interface IndexInfo {
+    name: string;
+    columns: string[];
+    unique: boolean;
+    primary: boolean;
+}
+export interface ForeignKeyInfo {
+    column: string;
+    references: {
+        table: string;
+        column: string;
+    };
+}
+export interface TableDescription {
+    table: string;
+    schema: string;
+    columns: ColumnInfo[];
+    indexes: IndexInfo[];
+    foreignKeys: ForeignKeyInfo[];
+    truncated: boolean;
+    truncationReason?: string;
+}
+export interface TableInfo {
+    name: string;
+    schema: string;
+    type: 'table' | 'view';
+    rows_estimate: number | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types for db-mcp server
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Error types and handling for db-mcp server
+ */
+export declare const ErrorCode: {
+    readonly INVALID_SQL: "INVALID_SQL";
+    readonly MULTI_STATEMENT: "MULTI_STATEMENT";
+    readonly QUERY_BLOCKED: "QUERY_BLOCKED";
+    readonly CONNECTION_FAILED: "CONNECTION_FAILED";
+    readonly QUERY_TIMEOUT: "QUERY_TIMEOUT";
+    readonly DATABASE_NOT_FOUND: "DATABASE_NOT_FOUND";
+    readonly CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+    readonly CONFIG_INVALID: "CONFIG_INVALID";
+    readonly READONLY_VIOLATION: "READONLY_VIOLATION";
+};
+export type ErrorCodeType = typeof ErrorCode[keyof typeof ErrorCode];
+export declare class DbMcpError extends Error {
+    readonly code: ErrorCodeType;
+    readonly details?: Record<string, unknown>;
+    constructor(code: ErrorCodeType, message: string, details?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;CAiBZ,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAErE,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,IAAI,EAAE,aAAa,CAAC;IACpC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYnF,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC"}

package/dist/utils/errors.js

@@ -0,0 +1,41 @@
+/**
+ * Error types and handling for db-mcp server
+ */
+export const ErrorCode = {
+    // SQL validation errors
+    INVALID_SQL: 'INVALID_SQL',
+    MULTI_STATEMENT: 'MULTI_STATEMENT',
+    QUERY_BLOCKED: 'QUERY_BLOCKED',
+    // Database errors
+    CONNECTION_FAILED: 'CONNECTION_FAILED',
+    QUERY_TIMEOUT: 'QUERY_TIMEOUT',
+    DATABASE_NOT_FOUND: 'DATABASE_NOT_FOUND',
+    // Configuration errors
+    CONFIG_NOT_FOUND: 'CONFIG_NOT_FOUND',
+    CONFIG_INVALID: 'CONFIG_INVALID',
+    // Access errors
+    READONLY_VIOLATION: 'READONLY_VIOLATION',
+};
+export class DbMcpError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'DbMcpError';
+        this.code = code;
+        this.details = details;
+        // Maintain proper stack trace in V8
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DbMcpError);
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            details: this.details,
+        };
+    }
+}
+//# sourceMappingURL=errors.js.map