mcp-database-inspector 2.0.1

package/README.md

@@ -0,0 +1,197 @@
+# MCP MySQL Inspector
+
+A powerful Model Context Protocol (MCP) server for inspecting MySQL database schemas, relationships, and structure. This tool provides AI assistants with comprehensive database introspection capabilities while maintaining strict read-only access for security.
+
+## 🚀 Features
+
+- **Read-Only Database Inspection**: Secure schema exploration without modification risks
+- **Multi-Database Support**: Connect to multiple MySQL databases simultaneously
+- **Comprehensive Schema Analysis**: Detailed table, column, index, and relationship information
+- **Foreign Key Relationship Mapping**: Understand data relationships across tables
+- **Index Performance Analysis**: Identify optimization opportunities
+- **Security-First Design**: Query validation, input sanitization, and audit logging
+- **Cross-Database Awareness**: Analyze relationships across multiple database instances
+
+## 📋 Requirements
+
+- Node.js 18 or higher
+- MySQL 5.7+ or compatible database (MariaDB, Aurora, etc.)
+- Network access to target database(s)
+- Valid database credentials with SELECT permissions
+
+## 📦 Installation
+
+### Global Installation
+```bash
+npm install -g mcp-mysql-inspector
+```
+
+### Local Development
+```bash
+git clone https://github.com/kokorolx/mcp-mysql-inspector.git
+cd mcp-mysql-inspector
+npm install
+npm run build
+```
+
+### MCP Client Integration
+
+#### Roo Configuration
+Create `roo-config.json`:
+```json
+{
+  "servers": {
+    "mysql-inspector": {
+      "command": "npx",
+      "args": [
+        "mcp-mysql-inspector",
+        "mysql://dev:password@localhost:3306/ecommerce",
+        "mysql://dev:password@localhost:3306/analytics"
+      ]
+    }
+  }
+}
+```
+
+#### Claude Desktop Configuration
+Add to `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "mysql-inspector": {
+      "command": "node",
+      "args": [
+        "/path/to/mcp-mysql-inspector/dist/index.js",
+        "mysql://username:password@localhost:3306/database1",
+        "mysql://username:password@localhost:3306/database2"
+      ]
+    }
+  }
+}
+```
+
+## 🛠 Available Tools
+
+### 1. `list_databases`
+Lists all connected databases with connection status.
+
+### 2. `list_tables`
+Lists all tables in a specified database with metadata.
+
+### 3. `inspect_table`
+Get complete table schema including columns, types, constraints, and metadata.
+Supports both single-table and multi-table inspection via the `table` (string) or `tables` (string[]) parameter.
+
+**Parameters:**
+- `database` (string, required): Name of the database.
+- `table` (string, optional): Name of a single table to inspect.
+- `tables` (string[], optional): Array of table names to inspect (multi-table mode).
+  Provide either `table` or `tables`, not both.
+
+**Examples:**
+```json
+{ "database": "mydb", "table": "users" }
+{ "database": "mydb", "tables": ["users", "orders", "products"] }
+```
+
+### 4. `get_foreign_keys`
+Get foreign key relationships for one or more tables, or the entire database.
+Supports both single-table and multi-table inspection via the `table` (string) or `tables` (string[]) parameter.
+
+**Parameters:**
+- `database` (string, required): Name of the database.
+- `table` (string, optional): Name of a single table to analyze.
+- `tables` (string[], optional): Array of table names to analyze (multi-table mode).
+  Provide either `table` or `tables`, not both.
+
+**Examples:**
+```json
+{ "database": "mydb", "table": "orders" }
+{ "database": "mydb", "tables": ["orders", "order_items"] }
+```
+
+### 5. `get_indexes`
+Get detailed index information for one or more tables.
+Supports both single-table and multi-table inspection via the `table` (string) or `tables` (string[]) parameter.
+
+**Parameters:**
+- `database` (string, required): Name of the database.
+- `table` (string, optional): Name of a single table to analyze.
+- `tables` (string[], optional): Array of table names to analyze (multi-table mode).
+  Provide either `table` or `tables`, not both.
+
+**Examples:**
+```json
+{ "database": "mydb", "table": "products" }
+{ "database": "mydb", "tables": ["products", "categories"] }
+```
+
+## 🔒 Security Features
+
+### Query Safety
+- **Whitelist-Only Approach**: Only SELECT, SHOW, DESCRIBE, EXPLAIN queries allowed
+- **SQL Injection Prevention**: Multi-layer validation and parameter binding
+- **Row Limits**: Automatic limits to prevent resource exhaustion
+- **Timeout Protection**: Internal query timeouts are enforced, but `timeout` is not a valid connection option.
+
+### Input Validation
+- **URL Validation**: Comprehensive connection string validation
+- **Identifier Sanitization**: MySQL identifier format validation
+- **Parameter Sanitization**: Input cleaning and null-byte removal
+
+### Audit & Logging
+- **Comprehensive Logging**: All operations logged with configurable levels
+- **Sensitive Data Masking**: Credentials automatically redacted from logs
+- **Performance Monitoring**: Query timing and resource usage tracking
+
+## ⚙️ Configuration
+
+### Environment Variables
+
+| Variable | Description | Default | Example |
+|----------|-------------|---------|----------|
+| `LOG_LEVEL` | Logging level (error, warn, info, debug, trace) | `info` | `LOG_LEVEL=debug` |
+
+### Database URL Format
+```
+mysql://username:password@hostname:port/database?options
+```
+
+**Supported Options:**
+- `ssl=true/false` - Enable/disable SSL connections
+<!--
+- `timeout=seconds` - (Not supported) The `timeout` option is not valid for MySQL2 Connection and will be ignored.
+-->
+
+## 🚨 Troubleshooting
+
+### Common Issues
+
+#### Connection Failures
+```bash
+# Test connection manually
+mysql -h hostname -u username -p database_name
+
+# Check network connectivity
+telnet hostname 3306
+
+# Verify credentials and permissions
+SHOW GRANTS FOR 'username'@'hostname';
+```
+
+#### Permission Errors
+Ensure the database user has at least:
+```sql
+GRANT SELECT ON database_name.* TO 'username'@'%';
+GRANT SELECT ON INFORMATION_SCHEMA.* TO 'username'@'%';
+```
+
+### Debug Mode
+Enable detailed logging:
+```bash
+LOG_LEVEL=debug mcp-mysql-inspector "mysql://..."
+```
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/database/connection.d.ts

@@ -0,0 +1,13 @@
+import { DatabaseType, DatabaseConnectionOptions, QueryResult } from './types.js';
+export declare class DatabaseConnection {
+    private static readonly DEFAULT_TIMEOUT;
+    private static readonly DEFAULT_ACQUIRE_TIMEOUT;
+    static detectDatabaseType(url: string): DatabaseType;
+    static parseConnectionUrl(url: string): DatabaseConnectionOptions;
+    static createConnection(options: DatabaseConnectionOptions): Promise<any>;
+    static executeQuery(connection: any, query: string, params?: any[], type?: DatabaseType): Promise<QueryResult>;
+    static closeConnection(connection: any, type?: DatabaseType): Promise<void>;
+    static testConnection(options: DatabaseConnectionOptions): Promise<boolean>;
+    static extractDatabaseName(url: string): string;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/database/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/database/connection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAKlF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAS;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IAExD,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IAYpD,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB;WAqCpD,gBAAgB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,GAAG,CAAC;WAqClE,YAAY,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,IAAI,GAAE,YAAiC,GAAG,OAAO,CAAC,WAAW,CAAC;WA2B3H,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,GAAE,YAAiC,GAAG,OAAO,CAAC,IAAI,CAAC;WAaxF,cAAc,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBjF,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAQhD"}

package/dist/database/connection.js

@@ -0,0 +1,155 @@
+import mysql from 'mysql2/promise';
+import { URL } from 'url';
+import { DatabaseType } from './types.js';
+import { Logger } from '../utils/logger.js';
+import { DatabaseError } from '../utils/errors.js';
+import { PostgresConnection } from './postgres-connection.js';
+export class DatabaseConnection {
+    static DEFAULT_TIMEOUT = 30000;
+    static DEFAULT_ACQUIRE_TIMEOUT = 60000;
+    static detectDatabaseType(url) {
+        try {
+            const protocol = new URL(url).protocol.replace(':', '');
+            if (protocol === 'mysql')
+                return DatabaseType.MySQL;
+            if (protocol === 'postgresql' || protocol === 'postgres')
+                return DatabaseType.PostgreSQL;
+            throw new DatabaseError(`Unsupported database protocol: ${protocol}. Supported protocols: mysql, postgresql, postgres.`);
+        }
+        catch (error) {
+            if (error instanceof DatabaseError)
+                throw error;
+            throw new DatabaseError(`Invalid connection URL: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    static parseConnectionUrl(url) {
+        const type = this.detectDatabaseType(url);
+        if (type === DatabaseType.PostgreSQL) {
+            return PostgresConnection.parseConnectionUrl(url);
+        }
+        // MySQL parsing logic (orig)
+        try {
+            const parsedUrl = new URL(url);
+            const options = {
+                type: DatabaseType.MySQL,
+                host: parsedUrl.hostname,
+                port: parsedUrl.port ? parseInt(parsedUrl.port) : 3306,
+                user: parsedUrl.username,
+                password: parsedUrl.password,
+                database: parsedUrl.pathname.slice(1), // Remove leading slash
+                reconnect: true
+            };
+            // Parse SSL settings from query parameters
+            const searchParams = parsedUrl.searchParams;
+            if (searchParams.has('ssl')) {
+                const sslValue = searchParams.get('ssl');
+                if (sslValue === 'true' || sslValue === '1') {
+                    options.ssl = true;
+                }
+                else if (sslValue === 'false' || sslValue === '0') {
+                    options.ssl = false;
+                }
+            }
+            return options;
+        }
+        catch (error) {
+            throw new DatabaseError(`Invalid connection URL: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    static async createConnection(options) {
+        if (options.type === DatabaseType.PostgreSQL) {
+            return PostgresConnection.createClient(options);
+        }
+        try {
+            Logger.info(`Connecting to MySQL database at ${options.host}:${options.port}/${options.database}`);
+            const connectionConfig = {
+                host: options.host,
+                port: options.port,
+                user: options.user,
+                password: options.password,
+                database: options.database,
+                multipleStatements: false,
+                dateStrings: true,
+            };
+            if (options.ssl === false) {
+                connectionConfig.ssl = false;
+            }
+            else if (options.ssl === true) {
+                connectionConfig.ssl = {};
+            }
+            else if (options.ssl && typeof options.ssl === 'object') {
+                connectionConfig.ssl = options.ssl;
+            }
+            const connection = await mysql.createConnection(connectionConfig);
+            await connection.ping();
+            Logger.info(`Successfully connected to MySQL database: ${options.database}`);
+            return connection;
+        }
+        catch (error) {
+            Logger.error(`Failed to connect to MySQL database: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new DatabaseError(`Connection failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    static async executeQuery(connection, query, params, type = DatabaseType.MySQL) {
+        if (type === DatabaseType.PostgreSQL) {
+            return PostgresConnection.executeQuery(connection, query, params);
+        }
+        try {
+            Logger.debug(`Executing MySQL query: ${query.substring(0, 100)}${query.length > 100 ? '...' : ''}`);
+            const [rows, fields] = await connection.execute(query, params);
+            const result = {
+                rows: Array.isArray(rows) ? rows : [],
+                fields: Array.isArray(fields) ? fields : [],
+            };
+            Logger.debug(`Query executed successfully, returned ${result.rows.length} rows`);
+            return result;
+        }
+        catch (error) {
+            Logger.error(`MySQL query execution failed: ${error instanceof Error ? error.message : 'Unknown error'}\n` +
+                `Full SQL: ${query}\n` +
+                `Params: ${JSON.stringify(params)}`);
+            throw new DatabaseError(`Query execution failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    static async closeConnection(connection, type = DatabaseType.MySQL) {
+        if (type === DatabaseType.PostgreSQL) {
+            return PostgresConnection.closeConnection(connection);
+        }
+        try {
+            await connection.end();
+            Logger.info('MySQL connection closed successfully');
+        }
+        catch (error) {
+            Logger.warn(`Error closing MySQL connection: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    static async testConnection(options) {
+        if (options.type === DatabaseType.PostgreSQL) {
+            return PostgresConnection.testConnection(options);
+        }
+        let connection = null;
+        try {
+            connection = await this.createConnection(options);
+            return true;
+        }
+        catch (error) {
+            Logger.warn(`MySQL connection test failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            return false;
+        }
+        finally {
+            if (connection) {
+                await this.closeConnection(connection);
+            }
+        }
+    }
+    static extractDatabaseName(url) {
+        try {
+            const parsedUrl = new URL(url);
+            return parsedUrl.pathname.slice(1) || 'default';
+        }
+        catch {
+            return 'default';
+        }
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/database/connection.js.map

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

package/dist/database/manager.d.ts

@@ -0,0 +1,28 @@
+import { DatabaseInfo, QueryResult, TableInfo, ColumnInfo, ForeignKeyInfo, IndexInfo, DatabaseType } from './types.js';
+export declare class DatabaseManager {
+    private databases;
+    private readonly connectionTimeout;
+    private readonly maxRowLimit;
+    addDatabase(url: string, name?: string): Promise<string>;
+    removeDatabase(name: string): Promise<void>;
+    listDatabases(): DatabaseInfo[];
+    getDatabaseType(dbName: string): DatabaseType;
+    private getConnection;
+    executeQuery(dbName: string, query: string, params?: any[]): Promise<QueryResult>;
+    private addRowLimitToQuery;
+    getTables(dbName: string): Promise<TableInfo[]>;
+    private getTablesPostgres;
+    getTableSchema(dbName: string, tableName: string): Promise<ColumnInfo[]>;
+    private getTableSchemaPostgres;
+    getForeignKeys(dbName: string, tableName?: string): Promise<ForeignKeyInfo[]>;
+    private getForeignKeysPostgres;
+    getIndexes(dbName: string, tableName: string): Promise<IndexInfo[]>;
+    private getIndexesPostgres;
+    cleanup(): Promise<void>;
+    queryInformationSchema(dbName: string, table: 'COLUMNS' | 'TABLES' | 'ROUTINES', filters?: Record<string, string>, limit?: number): Promise<QueryResult>;
+    analyzeQuery(dbName: string, query: string): Promise<any>;
+    private summarizePlan;
+    private traversePostgresPlan;
+    private traverseMySQLPlan;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/database/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/database/manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAMvI,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAEtC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmCxD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjD,aAAa,IAAI,YAAY,EAAE;IAW/B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;YAQ/B,aAAa;IAarB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA0BvF,OAAO,CAAC,kBAAkB;IAapB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAuCvC,iBAAiB;IAkCzB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAsDhE,sBAAsB;IAiD9B,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YAuDrE,sBAAsB;IA+C9B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YA8C3D,kBAAkB;IA0C1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxB,sBAAsB,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,EACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,KAAK,GAAE,MAAY,GAClB,OAAO,CAAC,WAAW,CAAC;IAoDjB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAsD/D,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,iBAAiB;CAc1B"}