db-mcp 2.0.0 → 3.0.1

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAEV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,EAGd,aAAa,EACb,eAAe,EAGf,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EAGd,SAAS,EACT,cAAc,EACd,gBAAgB,EAGhB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,eAAe,EACf,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,6 +1,4 @@
-export { DEFAULT_CONFIG, DbMcpServer, createServer } from './chunk-WBER5YY4.js';
-import './chunk-SFJQCNG7.js';
-export { DatabaseAdapter } from './chunk-Z7C2TM4L.js';
-export { NAME, VERSION } from './chunk-VIDSICEL.js';
-export { AuthenticationError, AuthorizationError, ConnectionError, QueryError, ValidationError } from './chunk-X3MUUOWM.js';
-export { ALL_TOOL_GROUPS, DbMcpError, META_GROUPS, TOOL_GROUPS, filterTools, getFilterSummary, getToolFilterFromEnv, isToolEnabled, parseToolFilter } from './chunk-645ZEFLA.js';
+export { DEFAULT_CONFIG, DbMcpServer, createServer } from './chunk-37G4DLL6.js';
+export { DatabaseAdapter } from './chunk-W5WQVNVX.js';
+export { NAME, VERSION } from './chunk-E5IESRTK.js';
+export { ALL_TOOL_GROUPS, AuthenticationError, AuthorizationError, ConnectionError, DbMcpError, META_GROUPS, QueryError, TOOL_GROUPS, ValidationError, filterTools, getFilterSummary, getToolFilterFromEnv, isToolEnabled, parseToolFilter } from './chunk-L552U3QS.js';

package/dist/server/mcp-server.d.ts

@@ -0,0 +1,66 @@
+/**
+ * db-mcp - Main MCP Server
+ *
+ * SQLite MCP server with OAuth 2.1 authentication,
+ * HTTP/SSE transport, and dynamic tool filtering.
+ */
+import type { McpServerConfig, DatabaseConfig } from "../types/index.js";
+import type { DatabaseAdapter } from "../adapters/database-adapter.js";
+/**
+ * Main db-mcp server class
+ *
+ * Manages database adapters, tool registration, and MCP protocol handling.
+ */
+export declare class DbMcpServer {
+    private server;
+    private adapters;
+    private toolFilter;
+    private config;
+    private auditLogger;
+    private backupManager;
+    private auditInterceptor;
+    private auditInitPromise;
+    constructor(config: McpServerConfig);
+    /**
+     * Register a database adapter
+     */
+    registerAdapter(adapter: DatabaseAdapter, config: DatabaseConfig): Promise<void>;
+    /**
+     * Get an adapter by ID
+     */
+    getAdapter(adapterId: string): DatabaseAdapter | undefined;
+    /**
+     * Get all registered adapters
+     */
+    getAdapters(): Map<string, DatabaseAdapter>;
+    /**
+     * Start the server with the configured transport
+     */
+    start(): Promise<void>;
+    /**
+     * Start server with stdio transport
+     */
+    private startStdio;
+    /**
+     * Start server with HTTP transport (Streamable HTTP with SSE support)
+     */
+    private startHttp;
+    /**
+     * Gracefully shut down the server
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Initialize the audit subsystem: logger, interceptor, backup manager,
+     * sqlite://audit resource, and audit backup tools.
+     */
+    private initializeAudit;
+}
+/**
+ * Create and configure a db-mcp server instance
+ */
+export declare function createServer(config: McpServerConfig): DbMcpServer;
+/**
+ * Default server configuration
+ */
+export declare const DEFAULT_CONFIG: Partial<McpServerConfig>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/server/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAyEvE;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,gBAAgB,CAA8B;gBAE1C,MAAM,EAAE,eAAe;IAkFnC;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC;IAqDhB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI1D;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAI3C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;YACW,UAAU;IAiBxB;;OAEG;YACW,SAAS;IAsDvB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC/B;;;OAGG;YACW,eAAe;CAmC9B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAEjE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,eAAe,CAKnD,CAAC"}

package/dist/server/registration/audit-tools.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DatabaseAdapter } from "../../adapters/database-adapter.js";
+import type { BackupManager } from "../../audit/backup-manager.js";
+import type { AuditLogger } from "../../audit/logger.js";
+/**
+ * Register the sqlite://audit resource for agent access to audit log.
+ */
+export declare function registerAuditResource(server: McpServer, auditLogger: AuditLogger | null, backupManager: BackupManager | null): void;
+/**
+ * Register audit backup tools for snapshot management.
+ */
+export declare function registerAuditBackupTools(server: McpServer, backupManager: BackupManager | null, adaptersMap: Map<string, DatabaseAdapter>): void;
+//# sourceMappingURL=audit-tools.d.ts.map

package/dist/server/registration/audit-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-tools.d.ts","sourceRoot":"","sources":["../../../src/server/registration/audit-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAsDzD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,aAAa,EAAE,aAAa,GAAG,IAAI,GAClC,IAAI,CAsCN;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACxC,IAAI,CAunBN"}

package/dist/server/registration/built-in-tools.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DatabaseAdapter } from "../../adapters/database-adapter.js";
+import type { McpServerConfig, ToolFilterConfig } from "../../types/index.js";
+/**
+ * Register built-in server tools (health, info, etc.)
+ */
+export declare function registerBuiltInTools(server: McpServer, adaptersMap: Map<string, DatabaseAdapter>, config: McpServerConfig, toolFilter: ToolFilterConfig): void;
+//# sourceMappingURL=built-in-tools.d.ts.map

package/dist/server/registration/built-in-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-tools.d.ts","sourceRoot":"","sources":["../../../src/server/registration/built-in-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAU9E;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACzC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,gBAAgB,GAC3B,IAAI,CAyIN"}

package/dist/server/registration/help-resources.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolFilterConfig } from "../../types/index.js";
+/**
+ * Register sqlite://help resources for on-demand reference documentation.
+ */
+export declare function registerHelpResources(server: McpServer, toolFilter: ToolFilterConfig): void;
+//# sourceMappingURL=help-resources.d.ts.map

package/dist/server/registration/help-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-resources.d.ts","sourceRoot":"","sources":["../../../src/server/registration/help-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,sBAAsB,CAAC;AAKxE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,gBAAgB,GAC3B,IAAI,CAiFN"}

package/dist/server/registration/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./built-in-tools.js";
+export * from "./help-resources.js";
+export * from "./audit-tools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/registration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/registration/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/{sqlite-U5KSYQXK.js → sqlite-TB56Z7G3.js}

@@ -1,10 +1,8 @@
-import { getCoreTools, getJsonHelperTools, getJsonOperationTools, getTextTools, getStatsTools, getVirtualTools, getVectorTools, getGeoTools, getAdminTools, getIntrospectionTools, getMigrationTools, getCodeModeTools, executeRead, executeWrite, isDDL, executeGeneral, getResourceDefinitions, getPromptDefinitions, applyCommonPragmas, autoEnableWal, detectAndSetJsonbSupport, SchemaManager } from './chunk-5Y42NPBP.js';
-export { getCoreTools } from './chunk-5Y42NPBP.js';
-import { DatabaseAdapter } from './chunk-Z7C2TM4L.js';
-import { getToolGroupIcon, VERSION } from './chunk-VIDSICEL.js';
-import './chunk-OKOVZ5QE.js';
-import { ConnectionError, ConfigurationError } from './chunk-X3MUUOWM.js';
-import { createModuleLogger, ERROR_CODES, DbMcpError } from './chunk-645ZEFLA.js';
+import { getCoreTools, getJsonHelperTools, getJsonOperationTools, getTextTools, getStatsTools, getVirtualTools, getVectorTools, getGeoTools, getAdminTools, getIntrospectionTools, getMigrationTools, getCodeModeTools, executeRead, executeWrite, isDDL, executeGeneral, getResourceDefinitions, getPromptDefinitions, applyCommonPragmas, autoEnableWal, detectAndSetJsonbSupport, SchemaManager } from './chunk-NV34JSQM.js';
+export { getCoreTools } from './chunk-NV34JSQM.js';
+import { DatabaseAdapter } from './chunk-W5WQVNVX.js';
+import { getToolGroupIcon, VERSION } from './chunk-E5IESRTK.js';
+import { createModuleLogger, ConnectionError, ConfigurationError, ERROR_CODES, DbMcpError } from './chunk-L552U3QS.js';
 import initSqlJs from 'sql.js';
 
 // src/adapters/sqlite/tools/index.ts
@@ -37,6 +35,10 @@ function getToolsByGroup(adapter, group) {
   return getAllToolDefinitions(adapter).filter((tool) => tool.group === group);
 }
 var log = createModuleLogger("SQLITE");
+var _sqlJsPromise = null;
+function getSqlJs() {
+  return _sqlJsPromise ??= initSqlJs();
+}
 async function connectSqliteDatabase(adapter, config) {
   if (config.type !== "sqlite") {
     throw new ConfigurationError(
@@ -46,7 +48,7 @@ async function connectSqliteDatabase(adapter, config) {
   }
   const sqliteConfig = config;
   try {
-    const sqlJsInstance = await initSqlJs();
+    const sqlJsInstance = await getSqlJs();
     const filePath = sqliteConfig.filePath ?? sqliteConfig.connectionString ?? ":memory:";
     let db;
     if (filePath === ":memory:") {
@@ -183,9 +185,31 @@ async function fallBackDescribeTable(adapter, tableName) {
     `SELECT COUNT(*) as count FROM "${tableName}"`
   );
   const rowCount = countResult.rows?.[0]?.["count"] ?? 0;
+  let strict = false;
+  try {
+    const listResult = await adapter.executeReadQuery(
+      `PRAGMA table_list("${tableName}")`
+    );
+    if (listResult.rows && listResult.rows.length > 0) {
+      strict = listResult.rows[0]?.["strict"] === 1;
+    }
+  } catch {
+    try {
+      const ddlResult = await adapter.executeReadQuery(
+        "SELECT sql FROM sqlite_master WHERE type = 'table' AND name = ?",
+        [tableName]
+      );
+      const ddl = ddlResult.rows?.[0]?.["sql"] ?? "";
+      if (/\)\s*STRICT/i.test(ddl)) {
+        strict = true;
+      }
+    } catch {
+    }
+  }
   return {
     name: tableName,
     type: "table",
+    strict,
     columns,
     rowCount
   };
@@ -245,6 +269,7 @@ var SqliteAdapter = class extends DatabaseAdapter {
   db = null;
   config = null;
   schemaManager = null;
+  cachedToolDefinitions = null;
   /**
    * Connect to a SQLite database
    */
@@ -282,7 +307,7 @@ var SqliteAdapter = class extends DatabaseAdapter {
         latencyMs,
         version,
         details: {
-          filePath: this.config?.filePath ?? this.config?.connectionString ?? ":memory:",
+          filePath: this.config?.filePath ?? this.config?.connectionString ? "<redacted>" : ":memory:",
           walMode: this.config?.options?.walMode ?? false
         }
       });
@@ -304,14 +329,17 @@ var SqliteAdapter = class extends DatabaseAdapter {
   /**
    * Execute a write query
    */
-  async executeWriteQuery(sql, params, skipValidation = false) {
+  async executeWriteQuery(sql, params) {
     this.ensureConnected();
-    if (!skipValidation) {
-      this.validateQuery(sql, false);
-    }
+    this.validateQuery(sql, false);
     const result = await executeWrite(this.ensureDb(), sql, params);
     if (isDDL(sql)) {
-      this.clearSchemaCache();
+      const match = /(?:table|view|index)\s+([a-zA-Z0-9_]+)/i.exec(sql);
+      if (match?.[1] && this.schemaManager) {
+        this.schemaManager.clearTableCache(match[1]);
+      } else {
+        this.clearSchemaCache();
+      }
     }
     return result;
   }
@@ -320,12 +348,27 @@ var SqliteAdapter = class extends DatabaseAdapter {
    */
   async executeQuery(sql, params) {
     this.ensureConnected();
+    this.validateQuery(sql, false);
     const result = await executeGeneral(this.ensureDb(), sql, params);
     if (isDDL(sql)) {
-      this.clearSchemaCache();
+      const match = /(?:table|view|index)\s+([a-zA-Z0-9_]+)/i.exec(sql);
+      if (match?.[1] && this.schemaManager) {
+        this.schemaManager.clearTableCache(match[1]);
+      } else {
+        this.clearSchemaCache();
+      }
     }
     return result;
   }
+  /**
+   * Execute a SQL script containing multiple statements
+   */
+  executeScript(sql) {
+    this.ensureConnected();
+    this.ensureDb().run(sql);
+    this.clearSchemaCache();
+    return Promise.resolve();
+  }
   /**
    * Get full database schema (cached via SchemaManager)
    */
@@ -429,7 +472,8 @@ var SqliteAdapter = class extends DatabaseAdapter {
    * Get all tool definitions
    */
   getToolDefinitions() {
-    return getAllToolDefinitions(this);
+    this.cachedToolDefinitions ??= getAllToolDefinitions(this);
+    return this.cachedToolDefinitions;
   }
   /**
    * Get tools filtered by adapter capabilities
@@ -513,7 +557,7 @@ var SqliteAdapter = class extends DatabaseAdapter {
    * Execute raw SQL and return results (for tools)
    */
   rawQuery(sql, params) {
-    return this.executeQuery(sql, params);
+    return executeGeneral(this.ensureDb(), sql, params);
   }
 };
 function createSqliteAdapter() {