@neverinfamous/mysql-mcp 2.1.0

package/dist/adapters/DatabaseAdapter.d.ts

@@ -0,0 +1,134 @@
+/**
+ * mysql-mcp - Database Adapter Interface
+ *
+ * Abstract base class that all database adapters must implement.
+ * Provides a consistent interface for database operations.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { DatabaseType, DatabaseConfig, QueryResult, SchemaInfo, TableInfo, HealthStatus, AdapterCapabilities, ToolDefinition, ResourceDefinition, PromptDefinition, RequestContext, ToolGroup } 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 state */
+    protected connected: boolean;
+    /**
+     * 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
+     */
+    abstract executeWriteQuery(sql: string, params?: unknown[]): 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 enabledTools - Set of enabled tool names (from filtering)
+     */
+    registerTools(server: McpServer, enabledTools: Set<string>): void;
+    /**
+     * Register a single tool with the MCP server
+     */
+    protected 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 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 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
+     */
+    validateQuery(sql: string, isReadOnly: boolean): void;
+    /**
+     * Create a request context for tool execution
+     */
+    createContext(requestId?: string): 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":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,SAAS,EACZ,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,8BAAsB,eAAe;IACjC,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAErC,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAElC,uBAAuB;IACvB,SAAS,CAAC,SAAS,UAAS;IAM5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAM3C;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAEhF;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAEjF;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAM5E;;OAEG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAE3C;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAE7D;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMzC;;OAEG;IACH,QAAQ,CAAC,eAAe,IAAI,mBAAmB;IAE/C;;OAEG;IACH,QAAQ,CAAC,sBAAsB,IAAI,SAAS,EAAE;IAM9C;;OAEG;IACH,QAAQ,CAAC,kBAAkB,IAAI,cAAc,EAAE;IAE/C;;OAEG;IACH,QAAQ,CAAC,sBAAsB,IAAI,kBAAkB,EAAE;IAEvD;;OAEG;IACH,QAAQ,CAAC,oBAAoB,IAAI,gBAAgB,EAAE;IAEnD;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;IAcjE;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAsCrE;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAQ1C;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAmCjF;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAQxC;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAuC3E;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAkCrD;;OAEG;IACH,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc;IAOjD;;OAEG;IACH,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUrC"}

package/dist/adapters/DatabaseAdapter.js

@@ -0,0 +1,211 @@
+/**
+ * mysql-mcp - Database Adapter Interface
+ *
+ * Abstract base class that all database adapters must implement.
+ * Provides a consistent interface for database operations.
+ */
+import { logger } from '../utils/logger.js';
+import { z } from 'zod';
+/**
+ * Abstract base class for database adapters
+ */
+export class DatabaseAdapter {
+    /** Connection state */
+    connected = false;
+    /**
+     * Check if connected to the database
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Register tools with the MCP server
+     * @param server - MCP server instance
+     * @param enabledTools - Set of enabled tool names (from filtering)
+     */
+    registerTools(server, enabledTools) {
+        const tools = this.getToolDefinitions();
+        let registered = 0;
+        for (const tool of tools) {
+            if (enabledTools.has(tool.name)) {
+                this.registerTool(server, tool);
+                registered++;
+            }
+        }
+        logger.info(`Registered ${registered}/${tools.length} tools from ${this.name}`);
+    }
+    /**
+     * Register a single tool with the MCP server
+     */
+    registerTool(server, tool) {
+        // MCP SDK server.tool() registration
+        // Build MCP tool options with annotations (MCP Spec 2025-11-25)
+        const toolOptions = {
+            description: tool.description,
+        };
+        // Add title if provided (human-readable display name)
+        if (tool.title) {
+            toolOptions['title'] = tool.title;
+        }
+        // Add behavioral annotations for AI clients
+        if (tool.annotations) {
+            toolOptions['annotations'] = tool.annotations;
+        }
+        // Create the tool options object with input schema
+        // registerTool expects options as the second argument
+        server.registerTool(tool.name, {
+            ...toolOptions,
+            inputSchema: tool.inputSchema
+        }, async (params) => {
+            const context = this.createContext();
+            const result = await tool.handler(params, context);
+            return {
+                content: [{
+                        type: 'text',
+                        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2)
+                    }]
+            };
+        });
+    }
+    /**
+     * Register resources with the MCP server
+     */
+    registerResources(server) {
+        const resources = this.getResourceDefinitions();
+        for (const resource of resources) {
+            this.registerResource(server, resource);
+        }
+        logger.info(`Registered ${resources.length} resources from ${this.name}`);
+    }
+    /**
+     * Register a single resource with the MCP server
+     */
+    registerResource(server, resource) {
+        // Build resource metadata with MCP 2025-11-25 enhancements
+        const resourceMeta = {
+            description: resource.description,
+            mimeType: resource.mimeType ?? 'application/json',
+        };
+        // Add title if provided
+        if (resource.title) {
+            resourceMeta['title'] = resource.title;
+        }
+        // Add annotations for AI clients (audience, priority, lastModified)
+        if (resource.annotations) {
+            resourceMeta['annotations'] = resource.annotations;
+        }
+        server.registerResource(resource.name, resource.uri, resourceMeta, async (uri) => {
+            const context = this.createContext();
+            const result = await resource.handler(uri.toString(), context);
+            return {
+                contents: [{
+                        uri: uri.toString(),
+                        mimeType: resource.mimeType ?? 'application/json',
+                        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2)
+                    }]
+            };
+        });
+    }
+    /**
+     * Register prompts with the MCP server
+     */
+    registerPrompts(server) {
+        const prompts = this.getPromptDefinitions();
+        for (const prompt of prompts) {
+            this.registerPrompt(server, prompt);
+        }
+        logger.info(`Registered ${prompts.length} prompts from ${this.name}`);
+    }
+    /**
+     * Register a single prompt with the MCP server
+     */
+    registerPrompt(server, prompt) {
+        // Build Zod schema from prompt.arguments definitions
+        const zodShape = {};
+        if (prompt.arguments) {
+            for (const arg of prompt.arguments) {
+                zodShape[arg.name] = arg.required
+                    ? z.string().describe(arg.description)
+                    : z.string().optional().describe(arg.description);
+            }
+        }
+        server.registerPrompt(prompt.name, {
+            description: prompt.description,
+            argsSchema: zodShape
+        }, async (providedArgs) => {
+            const context = this.createContext();
+            // Cast args to Record<string, string> for handler compatibility
+            const args = providedArgs;
+            const result = await prompt.handler(args, context);
+            return {
+                messages: [{
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: typeof result === 'string' ? result : JSON.stringify(result, null, 2)
+                        }
+                    }]
+            };
+        });
+    }
+    // =========================================================================
+    // Query Validation
+    // =========================================================================
+    /**
+     * Validate query for safety (SQL injection prevention)
+     * @param sql - SQL query to validate
+     * @param isReadOnly - Whether to enforce read-only restrictions
+     */
+    validateQuery(sql, isReadOnly) {
+        if (!sql || typeof sql !== 'string') {
+            throw new Error('Query must be a non-empty string');
+        }
+        const normalizedSql = sql.trim().toUpperCase();
+        // Check for dangerous patterns
+        const dangerousPatterns = [
+            /;\s*DROP\s+/i,
+            /;\s*DELETE\s+/i,
+            /;\s*TRUNCATE\s+/i,
+            /;\s*INSERT\s+/i,
+            /;\s*UPDATE\s+/i,
+            /--\s*$/m, // SQL comment at end of line
+        ];
+        for (const pattern of dangerousPatterns) {
+            if (pattern.test(sql)) {
+                throw new Error('Query contains potentially dangerous patterns');
+            }
+        }
+        // Enforce read-only for SELECT queries
+        if (isReadOnly) {
+            const writeKeywords = ['INSERT', 'UPDATE', 'DELETE', 'DROP', 'CREATE', 'ALTER', 'TRUNCATE', 'REPLACE', 'GRANT', 'REVOKE'];
+            for (const keyword of writeKeywords) {
+                if (normalizedSql.startsWith(keyword)) {
+                    throw new Error(`Read-only mode: ${keyword} statements are not allowed`);
+                }
+            }
+        }
+    }
+    /**
+     * Create a request context for tool execution
+     */
+    createContext(requestId) {
+        return {
+            timestamp: new Date(),
+            requestId: requestId ?? crypto.randomUUID()
+        };
+    }
+    /**
+     * 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/mysql/MySQLAdapter.d.ts

@@ -0,0 +1,88 @@
+/**
+ * mysql-mcp - MySQL Adapter
+ *
+ * Main MySQL database adapter with connection pooling,
+ * query execution, and tool registration.
+ */
+import type { PoolConnection } from 'mysql2/promise';
+import { DatabaseAdapter } from '../DatabaseAdapter.js';
+import { ConnectionPool } from '../../pool/ConnectionPool.js';
+import type { DatabaseConfig, QueryResult, SchemaInfo, TableInfo, IndexInfo, HealthStatus, AdapterCapabilities, ToolDefinition, ResourceDefinition, PromptDefinition, ToolGroup } from '../../types/index.js';
+/**
+ * MySQL Database Adapter
+ */
+export declare class MySQLAdapter extends DatabaseAdapter {
+    readonly type: "mysql";
+    readonly name = "MySQL Adapter";
+    readonly version = "0.1.0";
+    private pool;
+    private activeTransactions;
+    private cachedToolDefinitions;
+    private schemaManager;
+    connect(config: DatabaseConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    getHealth(): Promise<HealthStatus>;
+    executeReadQuery(sql: string, params?: unknown[], transactionId?: string): Promise<QueryResult>;
+    executeWriteQuery(sql: string, params?: unknown[], transactionId?: string): Promise<QueryResult>;
+    executeQuery(sql: string, params?: unknown[], transactionId?: string): Promise<QueryResult>;
+    /**
+     * Execute a query on a specific connection (for transactions)
+     */
+    executeOnConnection(connection: PoolConnection, sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Execute raw SQL using query() instead of execute()
+     * Use this for commands not supported in prepared statement protocol:
+     * - CHECK TABLE, SAVEPOINT, RELEASE SAVEPOINT, ROLLBACK TO SAVEPOINT
+     * - SHOW commands with LIKE patterns
+     */
+    rawQuery(sql: string): Promise<QueryResult>;
+    /**
+     * Begin a transaction
+     */
+    beginTransaction(isolationLevel?: string): Promise<string>;
+    /**
+     * Commit a transaction
+     */
+    commitTransaction(transactionId: string): Promise<void>;
+    /**
+     * Rollback a transaction
+     */
+    rollbackTransaction(transactionId: string): Promise<void>;
+    /**
+     * Get connection for a transaction
+     */
+    getTransactionConnection(transactionId: string): PoolConnection | undefined;
+    getSchema(): Promise<SchemaInfo>;
+    listTables(databaseName?: string): Promise<TableInfo[]>;
+    describeTable(tableName: string): Promise<TableInfo>;
+    listSchemas(): Promise<string[]>;
+    /**
+     * Get indexes for a table
+     */
+    getTableIndexes(tableName: string): Promise<IndexInfo[]>;
+    getCapabilities(): AdapterCapabilities;
+    getSupportedToolGroups(): ToolGroup[];
+    getToolDefinitions(): ToolDefinition[];
+    getResourceDefinitions(): ResourceDefinition[];
+    getPromptDefinitions(): PromptDefinition[];
+    /**
+     * Get the connection pool (for monitoring tools)
+     */
+    getPool(): ConnectionPool | null;
+    /**
+     * Check if error is due to unsupported prepared statement
+     */
+    private isUnsupportedPreparedStatementError;
+    /**
+     * Process execution results into QueryResult
+     */
+    /**
+     * Process execution results into QueryResult
+     */
+    private processExecutionResult;
+    /**
+     * Convert MySQL type number to name
+     */
+    private getTypeName;
+}
+//# sourceMappingURL=MySQLAdapter.d.ts.map

package/dist/adapters/mysql/MySQLAdapter.d.ts.map

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