db-mcp 1.0.1

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

@@ -0,0 +1,161 @@
+/**
+ * SQLite Adapter
+ *
+ * MCP adapter for SQLite databases using sql.js (WebAssembly).
+ * Provides 73 tools for database operations, JSON, text processing,
+ * statistics, vector search, and geospatial features.
+ */
+import { type Database } from "sql.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { DatabaseAdapter } from "../DatabaseAdapter.js";
+import type { DatabaseConfig, QueryResult, SchemaInfo, TableInfo, IndexInfo, HealthStatus, AdapterCapabilities, ToolDefinition, ResourceDefinition, PromptDefinition, ToolGroup } from "../../types/index.js";
+import type { SqliteConfig } from "./types.js";
+/**
+ * SQLite Database Adapter
+ *
+ * Implements the DatabaseAdapter interface for SQLite using sql.js.
+ * Supports file-based and in-memory databases.
+ */
+export declare class SqliteAdapter extends DatabaseAdapter {
+    readonly type: "sqlite";
+    readonly name = "SQLite Adapter";
+    readonly version = "1.0.0";
+    /**
+     * Check if this adapter uses native (better-sqlite3) backend.
+     * Returns false for WASM/sql.js adapter.
+     */
+    isNativeBackend(): boolean;
+    /**
+     * Get the configured database file path.
+     * Returns the user-configured path, not internal WASM virtual filesystem paths.
+     */
+    getConfiguredPath(): string;
+    private db;
+    protected config: SqliteConfig | null;
+    private sqlJsInstance;
+    private schemaManager;
+    /**
+     * Connect to a SQLite database
+     */
+    connect(config: DatabaseConfig): Promise<void>;
+    /**
+     * Apply SQLite PRAGMA options
+     */
+    private applyOptions;
+    /**
+     * Disconnect from the database
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get database health status
+     */
+    getHealth(): Promise<HealthStatus>;
+    /**
+     * Normalize parameters for SQLite binding
+     * Converts booleans to integers since SQLite doesn't have native boolean type
+     */
+    private normalizeParams;
+    /**
+     * Execute a read-only query
+     */
+    executeReadQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Execute a write query
+     */
+    executeWriteQuery(sql: string, params?: unknown[], skipValidation?: boolean): Promise<QueryResult>;
+    /**
+     * Execute any query (for admin operations)
+     */
+    executeQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Get full database schema (cached via SchemaManager)
+     */
+    getSchema(): Promise<SchemaInfo>;
+    /**
+     * List all tables (cached via SchemaManager)
+     */
+    listTables(): Promise<TableInfo[]>;
+    /**
+     * Describe a table's structure (cached via SchemaManager)
+     */
+    describeTable(tableName: string): Promise<TableInfo>;
+    /**
+     * List available schemas (SQLite has only 'main')
+     */
+    listSchemas(): Promise<string[]>;
+    /**
+     * Get indexes, optionally for a specific table (cached via SchemaManager)
+     */
+    getIndexes(table?: string): Promise<IndexInfo[]>;
+    /**
+     * Get all indexes in a single query (cached via SchemaManager)
+     * Performance optimization: eliminates N+1 query pattern
+     */
+    getAllIndexes(): Promise<IndexInfo[]>;
+    /**
+     * Clear the schema metadata cache
+     * Call after DDL operations or when fresh data is needed
+     */
+    clearSchemaCache(): void;
+    /**
+     * Get adapter capabilities
+     */
+    getCapabilities(): AdapterCapabilities;
+    /**
+     * Get supported tool groups
+     */
+    getSupportedToolGroups(): ToolGroup[];
+    /**
+     * Get all tool definitions
+     */
+    getToolDefinitions(): ToolDefinition[];
+    /**
+     * Get resource definitions
+     */
+    getResourceDefinitions(): ResourceDefinition[];
+    /**
+     * Get prompt definitions
+     */
+    getPromptDefinitions(): PromptDefinition[];
+    /**
+     * Get adapter info for metadata resource
+     */
+    getInfo(): {
+        type: string;
+        name: string;
+        version: string;
+        connected: boolean;
+    };
+    /**
+     * Register a single tool with the MCP server
+     * Uses modern registerTool() API for MCP 2025-11-25 compliance
+     */
+    protected registerTool(server: McpServer, tool: ToolDefinition): void;
+    /**
+     * Register a single resource with the MCP server
+     * Handles both static resources and URI templates
+     */
+    protected registerResource(server: McpServer, resource: ResourceDefinition): void;
+    /**
+     * Register a single prompt with the MCP server
+     */
+    protected registerPrompt(server: McpServer, prompt: PromptDefinition): void;
+    /**
+     * Ensure database is connected
+     */
+    private ensureConnected;
+    /**
+     * Ensure database is connected and return the database instance
+     */
+    private ensureDb;
+    /**
+     * Get the raw database instance (for tools)
+     */
+    getDatabase(): Database;
+    /**
+     * Execute raw SQL and return results (for tools)
+     */
+    rawQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+}
+export declare function createSqliteAdapter(): SqliteAdapter;
+//# sourceMappingURL=SqliteAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/sqlite/SqliteAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,UAAU,EACV,SAAS,EAET,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACV,MAAM,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAY9D;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAChD,SAAkB,IAAI,EAAG,QAAQ,CAAU;IAC3C,SAAkB,IAAI,oBAAoB;IAC1C,SAAkB,OAAO,WAAW;IAEpC;;;OAGG;IACH,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACH,iBAAiB,IAAI,MAAM;IAI3B,OAAO,CAAC,EAAE,CAAyB;IAEnC,UAAmB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAQ;IACtD,OAAO,CAAC,aAAa,CAAsD;IAC3E,OAAO,CAAC,aAAa,CAA8B;IAEnD;;OAEG;IACY,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoG7D;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B1C;;OAEG;IACM,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAiC3C;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACM,gBAAgB,CACvB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,WAAW,CAAC;IA6DvB;;OAEG;IACM,iBAAiB,CACxB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,EAClB,cAAc,UAAQ,GACrB,OAAO,CAAC,WAAW,CAAC;IAiDvB;;OAEG;IACM,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAgE5E;;OAEG;IACY,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAW/C;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAsBjD;;OAEG;IACY,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA+BnE;;OAEG;IACM,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzC;;OAEG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA6CtD;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAI3C;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAMxB;;OAEG;IACM,eAAe,IAAI,mBAAmB;IAY/C;;OAEG;IACM,sBAAsB,IAAI,SAAS,EAAE;IAI9C;;OAEG;IACM,kBAAkB,IAAI,cAAc,EAAE;IAI/C;;OAEG;IACM,sBAAsB,IAAI,kBAAkB,EAAE;IAIvD;;OAEG;IACM,oBAAoB,IAAI,gBAAgB,EAAE;IAInD;;OAEG;IACM,OAAO,IAAI;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB;IASD;;;OAGG;cACgB,YAAY,CAC7B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,GACnB,IAAI;IAuFP;;;OAGG;cACgB,gBAAgB,CACjC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,kBAAkB,GAC3B,IAAI;IAyEP;;OAEG;cACgB,cAAc,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,GACvB,IAAI;IAkCP;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,WAAW,IAAI,QAAQ;IAIvB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;CAGhE;AAGD,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}