db-mcp 1.0.1

package/dist/adapters/DatabaseAdapter.d.ts

@@ -0,0 +1,141 @@
+/**
+ * db-mcp - Database Adapter Interface
+ *
+ * Abstract base class for SQLite database adapters.
+ * Provides a consistent interface for SQLite database operations
+ * across WASM and native backend variants.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DatabaseConfig, DatabaseType, HealthStatus, QueryResult, SchemaInfo, TableInfo, AdapterCapabilities, ToolDefinition, ResourceDefinition, PromptDefinition, RequestContext, ToolGroup, ToolFilterConfig } from "../types/index.js";
+/**
+ * Abstract base class for database adapters
+ */
+export declare abstract class DatabaseAdapter {
+    /** Database type identifier */
+    abstract readonly type: DatabaseType;
+    /** Human-readable adapter name */
+    abstract readonly name: string;
+    /** Adapter version */
+    abstract readonly version: string;
+    /** Connection status */
+    protected connected: boolean;
+    /** Database configuration */
+    protected config: DatabaseConfig | null;
+    /**
+     * Connect to the database
+     * @param config - Database connection configuration
+     */
+    abstract connect(config: DatabaseConfig): Promise<void>;
+    /**
+     * Disconnect from the database
+     */
+    abstract disconnect(): Promise<void>;
+    /**
+     * Check if connected to the database
+     */
+    isConnected(): boolean;
+    /**
+     * Get health status of the database connection
+     */
+    abstract getHealth(): Promise<HealthStatus>;
+    /**
+     * Execute a read-only query (SELECT)
+     * @param sql - SQL query string
+     * @param params - Query parameters for prepared statements
+     */
+    abstract executeReadQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Execute a write query (INSERT, UPDATE, DELETE)
+     * @param sql - SQL query string
+     * @param params - Query parameters for prepared statements
+     * @param skipValidation - Skip security validation (for trusted internal operations)
+     */
+    abstract executeWriteQuery(sql: string, params?: unknown[], skipValidation?: boolean): Promise<QueryResult>;
+    /**
+     * Execute any query (for admin operations)
+     * @param sql - SQL query string
+     * @param params - Query parameters for prepared statements
+     */
+    abstract executeQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Get full database schema information
+     */
+    abstract getSchema(): Promise<SchemaInfo>;
+    /**
+     * List all tables in the database
+     */
+    abstract listTables(): Promise<TableInfo[]>;
+    /**
+     * Describe a specific table's structure
+     * @param tableName - Name of the table
+     */
+    abstract describeTable(tableName: string): Promise<TableInfo>;
+    /**
+     * List available schemas/databases
+     */
+    abstract listSchemas(): Promise<string[]>;
+    /**
+     * Get adapter capabilities
+     */
+    abstract getCapabilities(): AdapterCapabilities;
+    /**
+     * Get supported tool groups for this adapter
+     */
+    abstract getSupportedToolGroups(): ToolGroup[];
+    /**
+     * Get all tool definitions for this adapter
+     */
+    abstract getToolDefinitions(): ToolDefinition[];
+    /**
+     * Get all resource definitions for this adapter
+     */
+    abstract getResourceDefinitions(): ResourceDefinition[];
+    /**
+     * Get all prompt definitions for this adapter
+     */
+    abstract getPromptDefinitions(): PromptDefinition[];
+    /**
+     * Register tools with the MCP server
+     * @param server - MCP server instance
+     * @param filterConfig - Tool filter configuration
+     */
+    registerTools(server: McpServer, filterConfig: ToolFilterConfig): void;
+    /**
+     * Register a single tool with the MCP server
+     */
+    protected abstract registerTool(server: McpServer, tool: ToolDefinition): void;
+    /**
+     * Register resources with the MCP server
+     */
+    registerResources(server: McpServer): void;
+    /**
+     * Register a single resource with the MCP server
+     */
+    protected abstract registerResource(server: McpServer, resource: ResourceDefinition): void;
+    /**
+     * Register prompts with the MCP server
+     */
+    registerPrompts(server: McpServer): void;
+    /**
+     * Register a single prompt with the MCP server
+     */
+    protected abstract registerPrompt(server: McpServer, prompt: PromptDefinition): void;
+    /**
+     * Validate query for safety (SQL injection prevention)
+     * @param sql - SQL query to validate
+     * @param isReadOnly - Whether to enforce read-only restrictions
+     */
+    protected validateQuery(sql: string, isReadOnly: boolean): void;
+    /**
+     * Create a request context for tool execution
+     * @param requestId Optional request ID for tracing
+     * @param server Optional MCP Server instance for progress notifications
+     * @param progressToken Optional progress token from client request _meta
+     */
+    protected createContext(requestId?: string, server?: unknown, progressToken?: string | number): RequestContext;
+    /**
+     * Get adapter info for logging/debugging
+     */
+    getInfo(): Record<string, unknown>;
+}
+//# sourceMappingURL=DatabaseAdapter.d.ts.map

package/dist/adapters/DatabaseAdapter.d.ts.map

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

package/dist/adapters/DatabaseAdapter.js

@@ -0,0 +1,131 @@
+/**
+ * db-mcp - Database Adapter Interface
+ *
+ * Abstract base class for SQLite database adapters.
+ * Provides a consistent interface for SQLite database operations
+ * across WASM and native backend variants.
+ */
+import { isToolEnabled } from "../filtering/ToolFilter.js";
+/**
+ * Abstract base class for database adapters
+ */
+export class DatabaseAdapter {
+    /** Connection status */
+    connected = false;
+    /** Database configuration */
+    config = null;
+    /**
+     * Check if connected to the database
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Register tools with the MCP server
+     * @param server - MCP server instance
+     * @param filterConfig - Tool filter configuration
+     */
+    registerTools(server, filterConfig) {
+        const tools = this.getToolDefinitions();
+        for (const tool of tools) {
+            if (!isToolEnabled(tool, filterConfig)) {
+                continue;
+            }
+            // Register with MCP server
+            this.registerTool(server, tool);
+        }
+    }
+    /**
+     * Register resources with the MCP server
+     */
+    registerResources(server) {
+        const resources = this.getResourceDefinitions();
+        for (const resource of resources) {
+            this.registerResource(server, resource);
+        }
+    }
+    /**
+     * Register prompts with the MCP server
+     */
+    registerPrompts(server) {
+        const prompts = this.getPromptDefinitions();
+        for (const prompt of prompts) {
+            this.registerPrompt(server, prompt);
+        }
+    }
+    // ===========================================================================
+    // Utility Methods
+    // ===========================================================================
+    /**
+     * Validate query for safety (SQL injection prevention)
+     * @param sql - SQL query to validate
+     * @param isReadOnly - Whether to enforce read-only restrictions
+     */
+    validateQuery(sql, isReadOnly) {
+        const trimmedSql = sql.trim().toUpperCase();
+        if (isReadOnly) {
+            // For read-only queries, block mutating statements
+            const writePrefixes = [
+                "INSERT",
+                "UPDATE",
+                "DELETE",
+                "DROP",
+                "CREATE",
+                "ALTER",
+                "TRUNCATE",
+            ];
+            for (const prefix of writePrefixes) {
+                if (trimmedSql.startsWith(prefix)) {
+                    throw new Error(`Read-only mode: ${prefix} statements are not allowed`);
+                }
+            }
+        }
+        // Block obvious SQL injection patterns
+        // Note: This is a basic check; parameterized queries are the primary defense
+        const dangerousPatterns = [
+            /;\s*DROP\s+/i,
+            /;\s*DELETE\s+/i,
+            /;\s*TRUNCATE\s+/i,
+            /--.*$/m, // SQL comments (potential injection)
+            /\/\*.*\*\//s, // Block comments
+        ];
+        for (const pattern of dangerousPatterns) {
+            if (pattern.test(sql)) {
+                throw new Error("Query contains potentially dangerous patterns");
+            }
+        }
+    }
+    /**
+     * Create a request context for tool execution
+     * @param requestId Optional request ID for tracing
+     * @param server Optional MCP Server instance for progress notifications
+     * @param progressToken Optional progress token from client request _meta
+     */
+    createContext(requestId, server, progressToken) {
+        const context = {
+            timestamp: new Date(),
+            requestId: requestId ?? crypto.randomUUID(),
+        };
+        if (server !== undefined) {
+            context.server = server;
+        }
+        if (progressToken !== undefined) {
+            context.progressToken = progressToken;
+        }
+        return context;
+    }
+    /**
+     * Get adapter info for logging/debugging
+     */
+    getInfo() {
+        return {
+            type: this.type,
+            name: this.name,
+            version: this.version,
+            connected: this.connected,
+            capabilities: this.getCapabilities(),
+            toolGroups: this.getSupportedToolGroups(),
+        };
+    }
+}
+//# sourceMappingURL=DatabaseAdapter.js.map

package/dist/adapters/DatabaseAdapter.js.map

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

package/dist/adapters/sqlite/SchemaManager.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SQLite Schema Manager
+ *
+ * Provides TTL-based caching for schema metadata operations.
+ * Ported from mysql-mcp's SchemaManager pattern.
+ */
+import type { QueryResult, TableInfo, SchemaInfo, IndexInfo } from "../../types/index.js";
+export interface QueryExecutor {
+    executeReadQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+}
+/**
+ * SchemaManager provides cached access to database schema metadata.
+ * Reduces repeated schema queries during tool/resource invocations.
+ */
+export declare class SchemaManager {
+    private executor;
+    private metadataCache;
+    private cacheTtlMs;
+    constructor(executor: QueryExecutor);
+    /**
+     * Get cached value if not expired
+     */
+    private getCached;
+    /**
+     * Set cache value
+     */
+    private setCache;
+    /**
+     * Clear all cached metadata (useful after DDL operations)
+     */
+    clearCache(): void;
+    /**
+     * Get the current cache TTL in milliseconds
+     */
+    getCacheTtl(): number;
+    /**
+     * Get full database schema (cached)
+     */
+    getSchema(): Promise<SchemaInfo>;
+    /**
+     * List all tables (cached)
+     */
+    listTables(): Promise<TableInfo[]>;
+    /**
+     * Describe a table's structure (cached per table)
+     */
+    describeTable(tableName: string): Promise<TableInfo>;
+    /**
+     * Get all indexes in a single query (cached)
+     * Performance optimization: eliminates N+1 query pattern
+     */
+    getAllIndexes(): Promise<IndexInfo[]>;
+    /**
+     * Get indexes for a specific table (uses cached all_indexes)
+     */
+    getTableIndexes(tableName: string): Promise<IndexInfo[]>;
+}
+//# sourceMappingURL=SchemaManager.d.ts.map

package/dist/adapters/sqlite/SchemaManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaManager.d.ts","sourceRoot":"","sources":["../../../src/adapters/sqlite/SchemaManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,SAAS,EAEV,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACzE;AAgBD;;;GAGG;AACH,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ;IAH5B,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,UAAU,CAAwB;gBAEtB,QAAQ,EAAE,aAAa;IAE3C;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAYtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAoCxC;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAmD1D;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAwC3C;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAI/D"}

package/dist/adapters/sqlite/SchemaManager.js

@@ -0,0 +1,187 @@
+/**
+ * SQLite Schema Manager
+ *
+ * Provides TTL-based caching for schema metadata operations.
+ * Ported from mysql-mcp's SchemaManager pattern.
+ */
+/**
+ * Default cache TTL in milliseconds (configurable via METADATA_CACHE_TTL_MS env var)
+ * SQLite is embedded/local, so 5s default (vs mysql-mcp's 30s for network latency)
+ */
+const DEFAULT_CACHE_TTL_MS = parseInt(process.env["METADATA_CACHE_TTL_MS"] ?? "5000", 10);
+/**
+ * SchemaManager provides cached access to database schema metadata.
+ * Reduces repeated schema queries during tool/resource invocations.
+ */
+export class SchemaManager {
+    executor;
+    metadataCache = new Map();
+    cacheTtlMs = DEFAULT_CACHE_TTL_MS;
+    constructor(executor) {
+        this.executor = executor;
+    }
+    /**
+     * Get cached value if not expired
+     */
+    getCached(key) {
+        const entry = this.metadataCache.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() - entry.timestamp > this.cacheTtlMs) {
+            this.metadataCache.delete(key);
+            return undefined;
+        }
+        return entry.data;
+    }
+    /**
+     * Set cache value
+     */
+    setCache(key, data) {
+        this.metadataCache.set(key, { data, timestamp: Date.now() });
+    }
+    /**
+     * Clear all cached metadata (useful after DDL operations)
+     */
+    clearCache() {
+        this.metadataCache.clear();
+    }
+    /**
+     * Get the current cache TTL in milliseconds
+     */
+    getCacheTtl() {
+        return this.cacheTtlMs;
+    }
+    /**
+     * Get full database schema (cached)
+     */
+    async getSchema() {
+        const cached = this.getCached("schema");
+        if (cached)
+            return cached;
+        const tables = await this.listTables();
+        const indexes = await this.getAllIndexes();
+        const schema = { tables, indexes };
+        this.setCache("schema", schema);
+        return schema;
+    }
+    /**
+     * List all tables (cached)
+     */
+    async listTables() {
+        const cached = this.getCached("tables");
+        if (cached)
+            return cached;
+        const result = await this.executor.executeReadQuery(`SELECT name, type FROM sqlite_master 
+       WHERE type IN ('table', 'view') AND name NOT LIKE 'sqlite_%'
+       ORDER BY name`);
+        const tables = [];
+        for (const row of result.rows ?? []) {
+            const name = row["name"];
+            const type = row["type"];
+            // Skip FTS5 virtual tables and shadow tables (they're internal implementation details)
+            // - Virtual tables: end with "_fts" (e.g., "articles_fts")
+            // - Shadow tables: contain "_fts_" (e.g., "articles_fts_config", "articles_fts_data")
+            if (name.endsWith("_fts") || name.includes("_fts_")) {
+                continue;
+            }
+            try {
+                const tableInfo = await this.describeTable(name);
+                tables.push({ ...tableInfo, type });
+            }
+            catch {
+                // FTS5 virtual tables fail PRAGMA table_info in WASM mode (no FTS5 module)
+                // Skip these tables rather than failing the entire operation
+                continue;
+            }
+        }
+        this.setCache("tables", tables);
+        return tables;
+    }
+    /**
+     * Describe a table's structure (cached per table)
+     */
+    async describeTable(tableName) {
+        const cacheKey = `table_${tableName}`;
+        const cached = this.getCached(cacheKey);
+        if (cached)
+            return cached;
+        // Validate table name
+        if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(tableName)) {
+            throw new Error("Invalid table name");
+        }
+        const result = await this.executor.executeReadQuery(`PRAGMA table_info("${tableName}")`);
+        // Check if table exists (PRAGMA returns empty for non-existent tables)
+        if (!result.rows || result.rows.length === 0) {
+            throw new Error(`Table '${tableName}' does not exist`);
+        }
+        const columns = (result.rows ?? []).map((row) => ({
+            name: row["name"],
+            type: row["type"],
+            nullable: row["notnull"] === 0,
+            primaryKey: row["pk"] === 1,
+            defaultValue: row["dflt_value"],
+        }));
+        // Get row count (wrapped in try-catch for FTS5/virtual tables in WASM mode)
+        let rowCount = 0;
+        try {
+            const countResult = await this.executor.executeReadQuery(`SELECT COUNT(*) as count FROM "${tableName}"`);
+            rowCount = countResult.rows?.[0]?.["count"] ?? 0;
+        }
+        catch {
+            // FTS5 virtual tables may fail in WASM mode (no FTS5 module)
+            // Return 0 for row count rather than failing the entire operation
+            rowCount = 0;
+        }
+        const tableInfo = {
+            name: tableName,
+            type: "table",
+            columns,
+            rowCount,
+        };
+        this.setCache(cacheKey, tableInfo);
+        return tableInfo;
+    }
+    /**
+     * Get all indexes in a single query (cached)
+     * Performance optimization: eliminates N+1 query pattern
+     */
+    async getAllIndexes() {
+        const cached = this.getCached("all_indexes");
+        if (cached)
+            return cached;
+        const result = await this.executor.executeReadQuery(`SELECT name, tbl_name, sql FROM sqlite_master 
+       WHERE type = 'index' AND sql IS NOT NULL`);
+        const indexes = [];
+        for (const row of result.rows ?? []) {
+            const indexName = row["name"];
+            const tableName = row["tbl_name"];
+            const sql = row["sql"];
+            // Get column info for this index via PRAGMA index_info
+            let columns = [];
+            try {
+                const indexInfo = await this.executor.executeReadQuery(`PRAGMA index_info("${indexName}")`);
+                columns = (indexInfo.rows ?? []).map((col) => col["name"]);
+            }
+            catch {
+                // If PRAGMA fails, fall back to empty columns
+                columns = [];
+            }
+            indexes.push({
+                name: indexName,
+                tableName,
+                columns,
+                unique: sql?.toUpperCase().includes("UNIQUE") ?? false,
+            });
+        }
+        this.setCache("all_indexes", indexes);
+        return indexes;
+    }
+    /**
+     * Get indexes for a specific table (uses cached all_indexes)
+     */
+    async getTableIndexes(tableName) {
+        const allIndexes = await this.getAllIndexes();
+        return allIndexes.filter((idx) => idx.tableName === tableName);
+    }
+}
+//# sourceMappingURL=SchemaManager.js.map

package/dist/adapters/sqlite/SchemaManager.js.map

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