@neverinfamous/mysql-mcp 2.1.0

package/dist/adapters/mysql/SchemaManager.js

@@ -0,0 +1,260 @@
+import { ValidationError } from '../../types/index.js';
+/**
+ * Default cache TTL in milliseconds (configurable via METADATA_CACHE_TTL_MS env var)
+ */
+const DEFAULT_CACHE_TTL_MS = parseInt(process.env['METADATA_CACHE_TTL_MS'] ?? '30000', 10);
+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 schema changes)
+     */
+    clearCache() {
+        this.metadataCache.clear();
+    }
+    async getSchema() {
+        const tables = await this.listTables();
+        const views = tables.filter(t => t.type === 'view');
+        const realTables = tables.filter(t => t.type === 'table');
+        // Performance optimization: fetch all indexes in a single query instead of N+1
+        const indexes = await this.getAllIndexes();
+        return {
+            tables: realTables,
+            views,
+            indexes
+        };
+    }
+    /**
+     * Get all indexes across all tables in a single query
+     * Performance optimization: eliminates N+1 query pattern
+     */
+    async getAllIndexes() {
+        // Check cache first
+        const cached = this.getCached('all_indexes');
+        if (cached)
+            return cached;
+        const result = await this.executor.executeQuery(`
+            SELECT 
+                s.TABLE_NAME as tableName,
+                s.INDEX_NAME as name,
+                s.NON_UNIQUE as nonUnique,
+                s.COLUMN_NAME as columnName,
+                s.INDEX_TYPE as type,
+                s.CARDINALITY as cardinality
+            FROM information_schema.STATISTICS s
+            INNER JOIN information_schema.TABLES t 
+                ON s.TABLE_SCHEMA = t.TABLE_SCHEMA AND s.TABLE_NAME = t.TABLE_NAME
+            WHERE s.TABLE_SCHEMA = DATABASE()
+              AND t.TABLE_TYPE = 'BASE TABLE'
+            ORDER BY s.TABLE_NAME, s.INDEX_NAME, s.SEQ_IN_INDEX
+        `);
+        // Group columns by table+index name
+        const indexMap = new Map();
+        for (const row of result.rows ?? []) {
+            const tableName = row['tableName'];
+            const indexName = row['name'];
+            const mapKey = `${tableName}.${indexName}`;
+            const existing = indexMap.get(mapKey);
+            if (existing) {
+                existing.columns.push(row['columnName']);
+            }
+            else {
+                indexMap.set(mapKey, {
+                    name: indexName,
+                    tableName,
+                    columns: [row['columnName']],
+                    unique: row['nonUnique'] === 0,
+                    type: row['type'],
+                    cardinality: row['cardinality']
+                });
+            }
+        }
+        const indexes = Array.from(indexMap.values());
+        this.setCache('all_indexes', indexes);
+        return indexes;
+    }
+    async listTables(databaseName) {
+        const schemaClause = databaseName ? 'TABLE_SCHEMA = ?' : 'TABLE_SCHEMA = DATABASE()';
+        const params = databaseName ? [databaseName] : [];
+        const result = await this.executor.executeQuery(`
+            SELECT 
+                TABLE_NAME as name,
+                TABLE_TYPE as type,
+                ENGINE as engine,
+                TABLE_ROWS as rowCount,
+                DATA_LENGTH as dataLength,
+                INDEX_LENGTH as indexLength,
+                CREATE_TIME as createTime,
+                UPDATE_TIME as updateTime,
+                TABLE_COLLATION as collation,
+                TABLE_COMMENT as comment
+            FROM information_schema.TABLES
+            WHERE ${schemaClause}
+            ORDER BY TABLE_NAME
+        `, params);
+        return (result.rows ?? []).map(row => ({
+            name: row['name'],
+            type: row['type'] === 'VIEW' ? 'view' : 'table',
+            engine: row['engine'],
+            rowCount: row['rowCount'],
+            dataLength: row['dataLength'],
+            indexLength: row['indexLength'],
+            createTime: row['createTime'],
+            updateTime: row['updateTime'],
+            collation: row['collation'],
+            comment: row['comment']
+        }));
+    }
+    async describeTable(tableName) {
+        // Validate table name (allow schema.table format)
+        if (!/^[a-zA-Z0-9_]+(\.[a-zA-Z0-9_]+)?$/.test(tableName)) {
+            throw new ValidationError('Invalid table name');
+        }
+        const [part1, part2] = tableName.split('.');
+        let schemaName;
+        let shortTableName;
+        if (part2) {
+            schemaName = part1;
+            shortTableName = part2;
+        }
+        else {
+            shortTableName = tableName;
+        }
+        const schemaClause = schemaName ? 'TABLE_SCHEMA = ?' : 'TABLE_SCHEMA = DATABASE()';
+        const params = schemaName ? [schemaName, shortTableName] : [shortTableName];
+        // Get column information
+        const columnsResult = await this.executor.executeQuery(`
+            SELECT 
+                COLUMN_NAME as name,
+                DATA_TYPE as type,
+                IS_NULLABLE as nullable,
+                COLUMN_KEY as columnKey,
+                COLUMN_DEFAULT as defaultValue,
+                EXTRA as extra,
+                CHARACTER_SET_NAME as characterSet,
+                COLLATION_NAME as collation,
+                COLUMN_COMMENT as comment
+            FROM information_schema.COLUMNS
+            WHERE ${schemaClause}
+              AND TABLE_NAME = ?
+            ORDER BY ORDINAL_POSITION
+        `, params);
+        const columns = (columnsResult.rows ?? []).map(row => ({
+            name: row['name'],
+            type: row['type'],
+            nullable: row['nullable'] === 'YES',
+            primaryKey: row['columnKey'] === 'PRI',
+            defaultValue: row['defaultValue'],
+            autoIncrement: row['extra']?.includes('auto_increment'),
+            characterSet: row['characterSet'],
+            collation: row['collation'],
+            comment: row['comment']
+        }));
+        // Get table info
+        const tableResult = await this.executor.executeQuery(`
+            SELECT 
+                TABLE_TYPE as type,
+                ENGINE as engine,
+                TABLE_ROWS as rowCount,
+                TABLE_COLLATION as collation,
+                TABLE_COMMENT as comment
+            FROM information_schema.TABLES
+            WHERE ${schemaClause}
+              AND TABLE_NAME = ?
+        `, params);
+        const tableRow = tableResult.rows?.[0];
+        return {
+            name: tableName,
+            type: tableRow?.['type'] === 'VIEW' ? 'view' : 'table',
+            engine: tableRow?.['engine'],
+            rowCount: tableRow?.['rowCount'],
+            collation: tableRow?.['collation'],
+            comment: tableRow?.['comment'],
+            columns
+        };
+    }
+    async listSchemas() {
+        const result = await this.executor.executeQuery(`SHOW DATABASES`);
+        return (result.rows ?? []).map(row => {
+            const values = Object.values(row);
+            return values[0];
+        });
+    }
+    /**
+     * Get indexes for a table
+     */
+    async getTableIndexes(tableName) {
+        // Validate table name (allow schema.table format)
+        if (!/^[a-zA-Z0-9_]+(\.[a-zA-Z0-9_]+)?$/.test(tableName)) {
+            throw new ValidationError('Invalid table name');
+        }
+        const [part1, part2] = tableName.split('.');
+        let schemaName;
+        let shortTableName;
+        if (part2) {
+            schemaName = part1;
+            shortTableName = part2;
+        }
+        else {
+            shortTableName = tableName;
+        }
+        const schemaClause = schemaName ? 'TABLE_SCHEMA = ?' : 'TABLE_SCHEMA = DATABASE()';
+        const params = schemaName ? [schemaName, shortTableName] : [shortTableName];
+        const result = await this.executor.executeQuery(`
+            SELECT 
+                INDEX_NAME as name,
+                NON_UNIQUE as nonUnique,
+                COLUMN_NAME as columnName,
+                INDEX_TYPE as type,
+                CARDINALITY as cardinality
+            FROM information_schema.STATISTICS
+            WHERE ${schemaClause}
+              AND TABLE_NAME = ?
+            ORDER BY INDEX_NAME, SEQ_IN_INDEX
+        `, params);
+        // Group columns by index name
+        const indexMap = new Map();
+        for (const row of result.rows ?? []) {
+            const name = row['name'];
+            const existing = indexMap.get(name);
+            if (existing) {
+                existing.columns.push(row['columnName']);
+            }
+            else {
+                indexMap.set(name, {
+                    name,
+                    tableName,
+                    columns: [row['columnName']],
+                    unique: row['nonUnique'] === 0,
+                    type: row['type'],
+                    cardinality: row['cardinality']
+                });
+            }
+        }
+        return Array.from(indexMap.values());
+    }
+}
+//# sourceMappingURL=SchemaManager.js.map

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

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

package/dist/adapters/mysql/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MySQL Adapter - Module Index
+ */
+export { MySQLAdapter } from './MySQLAdapter.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/mysql/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,cAAc,YAAY,CAAC"}

package/dist/adapters/mysql/index.js

@@ -0,0 +1,7 @@
+/**
+ * MySQL Adapter - Module Index
+ */
+export { MySQLAdapter } from './MySQLAdapter.js';
+// Re-export types
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/mysql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/mysql/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,kBAAkB;AAClB,cAAc,YAAY,CAAC"}

package/dist/adapters/mysql/prompts/backupStrategy.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MySQL Prompt - Backup Strategy
+ *
+ * Enterprise backup planning with RTO/RPO considerations.
+ */
+import type { PromptDefinition } from '../../../types/index.js';
+export declare function createBackupStrategyPrompt(): PromptDefinition;
+//# sourceMappingURL=backupStrategy.d.ts.map

package/dist/adapters/mysql/prompts/backupStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupStrategy.d.ts","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/backupStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAEhF,wBAAgB,0BAA0B,IAAI,gBAAgB,CAyE7D"}

package/dist/adapters/mysql/prompts/backupStrategy.js

@@ -0,0 +1,74 @@
+export function createBackupStrategyPrompt() {
+    return {
+        name: 'mysql_backup_strategy',
+        description: 'Design enterprise backup strategy with RTO/RPO planning',
+        arguments: [
+            { name: 'rpo', description: 'Recovery Point Objective (e.g., "1 hour", "15 minutes")', required: false },
+            { name: 'rto', description: 'Recovery Time Objective (e.g., "4 hours", "30 minutes")', required: false },
+            { name: 'data_size', description: 'Approximate database size (e.g., "100GB", "2TB")', required: false }
+        ],
+        handler: (args, _context) => {
+            const rpo = args['rpo'] ?? 'to be determined';
+            const rto = args['rto'] ?? 'to be determined';
+            const dataSize = args['data_size'] ?? 'unknown';
+            return Promise.resolve(`# MySQL Backup Strategy Planning
+
+Design a comprehensive backup strategy for this MySQL database.
+
+**Requirements:**
+- **RPO (Recovery Point Objective):** ${rpo}
+- **RTO (Recovery Time Objective):** ${rto}
+- **Database Size:** ${dataSize}
+
+## Step 1: Assess Current State
+- Check current binary log configuration (\`mysql://replication\`)
+- Review storage engine (InnoDB recommended for consistent backups)
+- Identify critical tables/databases
+
+## Step 2: Choose Backup Method
+
+### Option A: mysqldump (Logical Backup)
+- **Pros:** Portable, human-readable, works with any storage engine
+- **Cons:** Slower for large databases, locks required for consistency
+- Use: \`mysql_create_dump\` tool
+- Best for: < 100GB, development, cross-version migration
+
+### Option B: MySQL Shell Dump (Parallel Logical Backup)
+- **Pros:** 10-20x faster than mysqldump, parallel execution
+- **Cons:** Requires MySQL Shell 8.0+
+- Use: \`mysqlsh_dump_instance\`, \`mysqlsh_dump_schemas\`
+- Best for: 100GB - 2TB, faster recovery needed
+
+### Option C: Physical Backup (Percona XtraBackup)
+- **Pros:** Hot backup, minimal locking, fast for large databases
+- **Cons:** Same MySQL version required for restore
+- Best for: > 500GB, production systems
+
+## Step 3: Configure Point-in-Time Recovery
+1. Enable binary logging:
+   - log_bin = mysql-bin
+   - expire_logs_days = 7 (or binlog_expire_logs_seconds)
+   - sync_binlog = 1 (for durability)
+
+2. Schedule full backups:
+   - Daily for most workloads
+   - Weekly for stable, low-change databases
+
+3. Continuously archive binary logs to separate storage
+
+## Step 4: Test Recovery
+1. Regularly test full restore to a different server
+2. Test point-in-time recovery procedure
+3. Document and automate recovery steps
+
+## Step 5: Create Backup Schedule
+Based on your RPO of ${rpo}:
+- Calculate backup frequency needed
+- Plan retention policy
+- Set up monitoring and alerting
+
+Please provide your RPO/RTO requirements if not specified, and I'll create a tailored backup plan.`);
+        }
+    };
+}
+//# sourceMappingURL=backupStrategy.js.map

package/dist/adapters/mysql/prompts/backupStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupStrategy.js","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/backupStrategy.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,0BAA0B;IACtC,OAAO;QACH,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,yDAAyD;QACtE,SAAS,EAAE;YACP,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,yDAAyD,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxG,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,yDAAyD,EAAE,QAAQ,EAAE,KAAK,EAAE;YACxG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,kDAAkD,EAAE,QAAQ,EAAE,KAAK,EAAE;SAC1G;QACD,OAAO,EAAE,CAAC,IAA4B,EAAE,QAAwB,EAAE,EAAE;YAChE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC;YAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC;YAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC;YAEhD,OAAO,OAAO,CAAC,OAAO,CAAC;;;;;wCAKK,GAAG;uCACJ,GAAG;uBACnB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA4CR,GAAG;;;;;mGAKyE,CAAC,CAAC;QAC7F,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/adapters/mysql/prompts/clusterSetup.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MySQL Prompt - InnoDB Cluster Setup
+ *
+ * Complete InnoDB Cluster and Group Replication setup guide.
+ */
+import type { PromptDefinition } from '../../../types/index.js';
+export declare function createSetupClusterPrompt(): PromptDefinition;
+//# sourceMappingURL=clusterSetup.d.ts.map

package/dist/adapters/mysql/prompts/clusterSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterSetup.d.ts","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/clusterSetup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAEhF,wBAAgB,wBAAwB,IAAI,gBAAgB,CA8G3D"}

package/dist/adapters/mysql/prompts/clusterSetup.js

@@ -0,0 +1,112 @@
+export function createSetupClusterPrompt() {
+    return {
+        name: 'mysql_setup_cluster',
+        description: 'Complete MySQL InnoDB Cluster and Group Replication setup guide',
+        arguments: [],
+        handler: (_args, _context) => {
+            return Promise.resolve(`# MySQL InnoDB Cluster Setup Guide
+
+InnoDB Cluster provides a complete high availability solution using Group Replication, MySQL Shell, and MySQL Router.
+
+## Prerequisites
+
+1. **MySQL 8.0+** (required for InnoDB Cluster)
+2. **MySQL Shell** installed
+3. **At least 3 servers** for fault tolerance
+4. **Network connectivity** between all nodes
+
+## Architecture
+
+\`\`\`
+┌─────────────────┐
+│  MySQL Router   │  ← Applications connect here
+└────────┬────────┘
+         │
+┌────────┴────────┐
+│  InnoDB Cluster │
+├─────────────────┤
+│ Primary (R/W)   │
+│ Secondary (R/O) │
+│ Secondary (R/O) │
+└─────────────────┘
+\`\`\`
+
+## Step 1: Configure Instances
+
+On each MySQL server, add to my.cnf:
+\`\`\`ini
+[mysqld]
+server_id = 1  # Unique per server
+gtid_mode = ON
+enforce_gtid_consistency = ON
+binlog_checksum = NONE
+\`\`\`
+
+## Step 2: Create Cluster (MySQL Shell)
+
+\`\`\`javascript
+// Connect to primary
+\\connect admin@primary-host:3306
+
+// Configure instance
+dba.configureInstance('admin@primary-host:3306');
+
+// Create cluster
+var cluster = dba.createCluster('myCluster');
+
+// Add instances
+cluster.addInstance('admin@secondary1:3306');
+cluster.addInstance('admin@secondary2:3306');
+\`\`\`
+
+## Step 3: Check Cluster Status
+
+\`\`\`javascript
+cluster.status()
+\`\`\`
+
+## Step 4: Bootstrap Router
+
+\`\`\`bash
+mysqlrouter --bootstrap admin@primary-host:3306 --user=mysqlrouter
+\`\`\`
+
+## Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| \`mysql_gr_status\` | Group Replication status |
+| \`mysql_gr_members\` | List group members |
+| \`mysql_gr_primary\` | Identify current primary |
+| \`mysql_gr_transactions\` | Pending/applied transactions |
+| \`mysql_gr_flow_control\` | Flow control stats |
+| \`mysql_cluster_status\` | InnoDB Cluster status |
+| \`mysql_cluster_instances\` | List cluster instances |
+| \`mysql_cluster_topology\` | Cluster topology |
+| \`mysql_cluster_router_status\` | Router integration |
+| \`mysql_cluster_switchover\` | Switchover recommendation |
+
+## Failover Handling
+
+Automatic failover happens when:
+1. Primary becomes unreachable
+2. Majority of nodes agree (quorum)
+3. New primary is elected
+
+Manual failover:
+\`\`\`javascript
+cluster.setPrimaryInstance('admin@new-primary:3306')
+\`\`\`
+
+## Best Practices
+
+1. **Use odd number of nodes** (3, 5, 7) for quorum
+2. **Deploy Router on app servers** for low latency
+3. **Monitor replication lag** with flow control
+4. **Test failover regularly** in staging
+
+Start by checking cluster status with \`mysql_cluster_status\`.`);
+        }
+    };
+}
+//# sourceMappingURL=clusterSetup.js.map

package/dist/adapters/mysql/prompts/clusterSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterSetup.js","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/clusterSetup.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,wBAAwB;IACpC,OAAO;QACH,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,iEAAiE;QAC9E,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,CAAC,KAA6B,EAAE,QAAwB,EAAE,EAAE;YACjE,OAAO,OAAO,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAqG6B,CAAC,CAAC;QAC1D,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/adapters/mysql/prompts/docstoreSetup.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MySQL Prompt - Document Store Setup
+ *
+ * Complete Document Store / X DevAPI setup guide.
+ */
+import type { PromptDefinition } from '../../../types/index.js';
+export declare function createSetupDocstorePrompt(): PromptDefinition;
+//# sourceMappingURL=docstoreSetup.d.ts.map

package/dist/adapters/mysql/prompts/docstoreSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docstoreSetup.d.ts","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/docstoreSetup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAEhF,wBAAgB,yBAAyB,IAAI,gBAAgB,CAmH5D"}

package/dist/adapters/mysql/prompts/docstoreSetup.js

@@ -0,0 +1,117 @@
+export function createSetupDocstorePrompt() {
+    return {
+        name: 'mysql_setup_docstore',
+        description: 'Complete MySQL Document Store and X DevAPI setup guide',
+        arguments: [],
+        handler: (_args, _context) => {
+            return Promise.resolve(`# MySQL Document Store Setup Guide
+
+MySQL Document Store allows you to store and query JSON documents using collections, similar to NoSQL databases.
+
+## Prerequisites
+
+1. **MySQL 8.0+** (full Document Store support)
+2. **X Plugin enabled** (default in 8.0)
+3. **MySQL Shell** for X DevAPI access
+4. **Port 33060** open (X Protocol)
+
+## Step 1: Verify X Plugin
+
+\`\`\`sql
+SHOW PLUGINS WHERE Name = 'mysqlx';
+-- Should show: mysqlx | ACTIVE
+\`\`\`
+
+If not enabled:
+\`\`\`sql
+INSTALL PLUGIN mysqlx SONAME 'mysqlx.so';
+\`\`\`
+
+## Step 2: Create a Collection (MySQL Shell)
+
+\`\`\`javascript
+// Connect using X Protocol
+\\connect mysqlx://user@localhost:33060/mydb
+
+// Create collection
+db.createCollection('users')
+
+// Add documents
+db.users.add({
+    "_id": "user001",
+    "name": "John Doe",
+    "email": "john@example.com",
+    "tags": ["admin", "active"]
+})
+\`\`\`
+
+## Step 3: Query Documents
+
+\`\`\`javascript
+// Find all
+db.users.find()
+
+// Find with filter
+db.users.find("name = 'John Doe'")
+
+// Find with JSON path
+db.users.find("'admin' IN tags")
+\`\`\`
+
+## SQL Access to Collections
+
+Collections are regular tables with a JSON column:
+\`\`\`sql
+-- View collection data
+SELECT * FROM mydb.users;
+
+-- Query with JSON functions
+SELECT doc->>'$.name' AS name
+FROM mydb.users
+WHERE JSON_CONTAINS(doc->'$.tags', '"admin"');
+\`\`\`
+
+## Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| \`mysql_doc_list_collections\` | List collections |
+| \`mysql_doc_create_collection\` | Create collection |
+| \`mysql_doc_drop_collection\` | Drop collection |
+| \`mysql_doc_find\` | Query documents |
+| \`mysql_doc_add\` | Add documents |
+| \`mysql_doc_modify\` | Update documents |
+| \`mysql_doc_remove\` | Delete documents |
+| \`mysql_doc_create_index\` | Create index |
+| \`mysql_doc_collection_info\` | Collection stats |
+
+## Creating Indexes
+
+\`\`\`javascript
+// Index on document field
+db.users.createIndex("email_idx", {
+    fields: [{
+        field: "$.email",
+        type: "TEXT(100)"
+    }]
+})
+\`\`\`
+
+## Best Practices
+
+1. **Use _id field** for document identification
+2. **Create indexes** on frequently queried fields
+3. **Use JSON schema validation** for data integrity
+4. **Consider hybrid approach** - mix relational and document data
+
+## Common Issues
+
+1. **Port 33060 blocked**: Open firewall for X Protocol
+2. **Connection refused**: Verify mysqlx plugin is running
+3. **Schema not found**: Create database first
+
+Start by listing collections with \`mysql_doc_list_collections\`.`);
+        }
+    };
+}
+//# sourceMappingURL=docstoreSetup.js.map

package/dist/adapters/mysql/prompts/docstoreSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docstoreSetup.js","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/docstoreSetup.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,yBAAyB;IACrC,OAAO;QACH,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,wDAAwD;QACrE,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,CAAC,KAA6B,EAAE,QAAwB,EAAE,EAAE;YACjE,OAAO,OAAO,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEA0G+B,CAAC,CAAC;QAC5D,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/adapters/mysql/prompts/eventScheduler.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MySQL Prompt - Event Scheduler Setup
+ *
+ * Complete Event Scheduler configuration guide.
+ */
+import type { PromptDefinition } from '../../../types/index.js';
+export declare function createSetupEventsPrompt(): PromptDefinition;
+//# sourceMappingURL=eventScheduler.d.ts.map

package/dist/adapters/mysql/prompts/eventScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventScheduler.d.ts","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/eventScheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAEhF,wBAAgB,uBAAuB,IAAI,gBAAgB,CA+F1D"}