@neverinfamous/mysql-mcp 2.1.0

package/dist/adapters/mysql/tools/spatial/queries.js

@@ -0,0 +1,205 @@
+/**
+ * MySQL Spatial/GIS Tools - Spatial Queries
+ *
+ * Tools for querying spatial relationships and distances.
+ * 4 tools: distance, distance_sphere, contains, within.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Zod Schemas
+// =============================================================================
+const DistanceSchema = z.object({
+    table: z.string().describe('Table name'),
+    spatialColumn: z.string().describe('Spatial column name'),
+    point: z.object({
+        longitude: z.number(),
+        latitude: z.number()
+    }).describe('Reference point'),
+    maxDistance: z.number().optional().describe('Maximum distance in meters'),
+    limit: z.number().default(20).describe('Maximum results'),
+    srid: z.number().default(4326).describe('SRID')
+});
+const ContainsSchema = z.object({
+    table: z.string().describe('Table name'),
+    spatialColumn: z.string().describe('Spatial column name'),
+    polygon: z.string().describe('WKT polygon to test containment'),
+    limit: z.number().default(100).describe('Maximum results'),
+    srid: z.number().default(4326).describe('SRID of the input geometry (default: 4326 for GPS coordinates)')
+});
+const WithinSchema = z.object({
+    table: z.string().describe('Table name'),
+    spatialColumn: z.string().describe('Spatial column name'),
+    geometry: z.string().describe('WKT geometry to test within'),
+    limit: z.number().default(100).describe('Maximum results'),
+    srid: z.number().default(4326).describe('SRID of the input geometry (default: 4326 for GPS coordinates)')
+});
+/**
+ * Calculate distance between geometries
+ */
+export function createSpatialDistanceTool(adapter) {
+    return {
+        name: 'mysql_spatial_distance',
+        title: 'MySQL Spatial Distance',
+        description: 'Find rows within a certain distance from a point (Cartesian distance).',
+        group: 'spatial',
+        inputSchema: DistanceSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, spatialColumn, point, maxDistance, limit, srid } = DistanceSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(spatialColumn)) {
+                throw new Error('Invalid column name');
+            }
+            // Use 'axis-order=long-lat' to accept natural longitude-latitude order
+            const pointWkt = `POINT(${String(point.longitude)} ${String(point.latitude)})`;
+            let query = `
+                SELECT *,
+                       ST_Distance(\`${spatialColumn}\`, ST_GeomFromText(?, ${String(srid)}, 'axis-order=long-lat')) as distance
+                FROM \`${table}\`
+            `;
+            const queryParams = [pointWkt];
+            if (maxDistance !== undefined) {
+                query += ` WHERE ST_Distance(\`${spatialColumn}\`, ST_GeomFromText(?, ${String(srid)}, 'axis-order=long-lat')) <= ?`;
+                queryParams.push(pointWkt, maxDistance);
+            }
+            query += ` ORDER BY distance LIMIT ${String(limit)}`;
+            const result = await adapter.executeQuery(query, queryParams);
+            return {
+                results: result.rows ?? [],
+                count: result.rows?.length ?? 0,
+                referencePoint: point
+            };
+        }
+    };
+}
+/**
+ * Calculate spherical distance
+ */
+export function createSpatialDistanceSphereTool(adapter) {
+    return {
+        name: 'mysql_spatial_distance_sphere',
+        title: 'MySQL Spherical Distance',
+        description: 'Calculate distance on a sphere (for geographic coordinates). Returns distance in meters.',
+        group: 'spatial',
+        inputSchema: DistanceSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, spatialColumn, point, maxDistance, limit, srid } = DistanceSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(spatialColumn)) {
+                throw new Error('Invalid column name');
+            }
+            // Use 'axis-order=long-lat' to accept natural longitude-latitude order
+            const pointWkt = `POINT(${String(point.longitude)} ${String(point.latitude)})`;
+            let query = `
+                SELECT *,
+                       ST_Distance_Sphere(\`${spatialColumn}\`, ST_GeomFromText(?, ${String(srid)}, 'axis-order=long-lat')) as distance_meters
+                FROM \`${table}\`
+            `;
+            const queryParams = [pointWkt];
+            if (maxDistance !== undefined) {
+                query += ` WHERE ST_Distance_Sphere(\`${spatialColumn}\`, ST_GeomFromText(?, ${String(srid)}, 'axis-order=long-lat')) <= ?`;
+                queryParams.push(pointWkt, maxDistance);
+            }
+            query += ` ORDER BY distance_meters LIMIT ${String(limit)}`;
+            const result = await adapter.executeQuery(query, queryParams);
+            return {
+                results: result.rows ?? [],
+                count: result.rows?.length ?? 0,
+                referencePoint: point,
+                unit: 'meters'
+            };
+        }
+    };
+}
+/**
+ * Find geometries contained within a polygon
+ */
+export function createSpatialContainsTool(adapter) {
+    return {
+        name: 'mysql_spatial_contains',
+        title: 'MySQL Spatial Contains',
+        description: 'Find rows where the geometry is contained within a specified polygon.',
+        group: 'spatial',
+        inputSchema: ContainsSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, spatialColumn, polygon, limit, srid } = ContainsSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(spatialColumn)) {
+                throw new Error('Invalid column name');
+            }
+            const query = `
+                SELECT *
+                FROM \`${table}\`
+                WHERE ST_Contains(ST_GeomFromText(?, ${String(srid)}), \`${spatialColumn}\`)
+                LIMIT ${String(limit)}
+            `;
+            const result = await adapter.executeQuery(query, [polygon]);
+            return {
+                results: result.rows ?? [],
+                count: result.rows?.length ?? 0
+            };
+        }
+    };
+}
+/**
+ * Find geometries within another geometry
+ */
+export function createSpatialWithinTool(adapter) {
+    return {
+        name: 'mysql_spatial_within',
+        title: 'MySQL Spatial Within',
+        description: 'Find rows where the geometry is within a specified geometry.',
+        group: 'spatial',
+        inputSchema: WithinSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, spatialColumn, geometry, limit, srid } = WithinSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(spatialColumn)) {
+                throw new Error('Invalid column name');
+            }
+            const query = `
+                SELECT *
+                FROM \`${table}\`
+                WHERE ST_Within(\`${spatialColumn}\`, ST_GeomFromText(?, ${String(srid)}))
+                LIMIT ${String(limit)}
+            `;
+            const result = await adapter.executeQuery(query, [geometry]);
+            return {
+                results: result.rows ?? [],
+                count: result.rows?.length ?? 0
+            };
+        }
+    };
+}
+//# sourceMappingURL=queries.js.map

package/dist/adapters/mysql/tools/spatial/queries.js.map

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

package/dist/adapters/mysql/tools/spatial/setup.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MySQL Spatial/GIS Tools - Setup and Schema Management
+ *
+ * Tools for creating and managing spatial columns and indexes.
+ * 2 tools: column creation and index creation.
+ */
+import type { MySQLAdapter } from '../../MySQLAdapter.js';
+import type { ToolDefinition } from '../../../../types/index.js';
+/**
+ * Add a spatial column to a table
+ */
+export declare function createSpatialCreateColumnTool(adapter: MySQLAdapter): ToolDefinition;
+/**
+ * Create a spatial index
+ */
+export declare function createSpatialCreateIndexTool(adapter: MySQLAdapter): ToolDefinition;
+//# sourceMappingURL=setup.d.ts.map

package/dist/adapters/mysql/tools/spatial/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/spatial/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,4BAA4B,CAAC;AAoBjF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAgCnF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAkClF"}

package/dist/adapters/mysql/tools/spatial/setup.js

@@ -0,0 +1,85 @@
+/**
+ * MySQL Spatial/GIS Tools - Setup and Schema Management
+ *
+ * Tools for creating and managing spatial columns and indexes.
+ * 2 tools: column creation and index creation.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Zod Schemas
+// =============================================================================
+const SpatialColumnSchema = z.object({
+    table: z.string().describe('Table name'),
+    column: z.string().describe('Column name'),
+    type: z.enum(['POINT', 'LINESTRING', 'POLYGON', 'GEOMETRY', 'MULTIPOINT', 'MULTILINESTRING', 'MULTIPOLYGON', 'GEOMETRYCOLLECTION']).default('GEOMETRY').describe('Geometry type'),
+    srid: z.number().default(4326).describe('Spatial Reference System ID (4326 = WGS84)'),
+    nullable: z.boolean().default(true).describe('Allow NULL values')
+});
+const SpatialIndexSchema = z.object({
+    table: z.string().describe('Table name'),
+    column: z.string().describe('Spatial column name'),
+    indexName: z.string().optional().describe('Index name (auto-generated if not provided)')
+});
+/**
+ * Add a spatial column to a table
+ */
+export function createSpatialCreateColumnTool(adapter) {
+    return {
+        name: 'mysql_spatial_create_column',
+        title: 'MySQL Create Spatial Column',
+        description: 'Add a geometry/spatial column to an existing table.',
+        group: 'spatial',
+        inputSchema: SpatialColumnSchema,
+        requiredScopes: ['write'],
+        annotations: {
+            readOnlyHint: false
+        },
+        handler: async (params, _context) => {
+            const { table, column, type, srid, nullable } = SpatialColumnSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(column)) {
+                throw new Error('Invalid column name');
+            }
+            const nullClause = nullable ? '' : ' NOT NULL';
+            const sridClause = srid ? ` SRID ${String(srid)}` : '';
+            await adapter.executeQuery(`ALTER TABLE \`${table}\` ADD COLUMN \`${column}\` ${type}${sridClause}${nullClause}`);
+            return { success: true, table, column, type, srid };
+        }
+    };
+}
+/**
+ * Create a spatial index
+ */
+export function createSpatialCreateIndexTool(adapter) {
+    return {
+        name: 'mysql_spatial_create_index',
+        title: 'MySQL Create Spatial Index',
+        description: 'Create a SPATIAL index on a geometry column for faster queries.',
+        group: 'spatial',
+        inputSchema: SpatialIndexSchema,
+        requiredScopes: ['write'],
+        annotations: {
+            readOnlyHint: false
+        },
+        handler: async (params, _context) => {
+            const { table, column, indexName } = SpatialIndexSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(column)) {
+                throw new Error('Invalid column name');
+            }
+            const idxName = indexName ?? `idx_spatial_${table}_${column}`;
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(idxName)) {
+                throw new Error('Invalid index name');
+            }
+            await adapter.executeQuery(`CREATE SPATIAL INDEX \`${idxName}\` ON \`${table}\` (\`${column}\`)`);
+            return { success: true, indexName: idxName, table, column };
+        }
+    };
+}
+//# sourceMappingURL=setup.js.map

package/dist/adapters/mysql/tools/spatial/setup.js.map

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

package/dist/adapters/mysql/tools/stats/comparative.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MySQL Comparative and Advanced Statistics Tools
+ *
+ * Tools for advanced statistical analysis: correlation, regression, and histogram.
+ * 3 tools total.
+ */
+import type { MySQLAdapter } from '../../MySQLAdapter.js';
+import type { ToolDefinition } from '../../../../types/index.js';
+/**
+ * Calculate correlation coefficient
+ */
+export declare function createCorrelationTool(adapter: MySQLAdapter): ToolDefinition;
+/**
+ * Linear regression analysis
+ */
+export declare function createRegressionTool(adapter: MySQLAdapter): ToolDefinition;
+/**
+ * Column histogram management
+ */
+export declare function createHistogramTool(adapter: MySQLAdapter): ToolDefinition;
+//# sourceMappingURL=comparative.d.ts.map

package/dist/adapters/mysql/tools/stats/comparative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparative.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/stats/comparative.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,4BAA4B,CAAC;AA+BjF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAwE3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA8E1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAoEzE"}

package/dist/adapters/mysql/tools/stats/comparative.js

@@ -0,0 +1,247 @@
+/**
+ * MySQL Comparative and Advanced Statistics Tools
+ *
+ * Tools for advanced statistical analysis: correlation, regression, and histogram.
+ * 3 tools total.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Schemas
+// =============================================================================
+const CorrelationSchema = z.object({
+    table: z.string().describe('Table name'),
+    column1: z.string().describe('First numeric column'),
+    column2: z.string().describe('Second numeric column'),
+    where: z.string().optional().describe('Optional WHERE clause condition')
+});
+const RegressionSchema = z.object({
+    table: z.string().describe('Table name'),
+    xColumn: z.string().describe('Independent variable column'),
+    yColumn: z.string().describe('Dependent variable column'),
+    where: z.string().optional().describe('Optional WHERE clause condition')
+});
+const HistogramSchema = z.object({
+    table: z.string().describe('Table name'),
+    column: z.string().describe('Column for histogram'),
+    buckets: z.number().default(16).describe('Number of histogram buckets (max 1024)'),
+    update: z.boolean().default(false).describe('Whether to create/update the histogram')
+});
+// =============================================================================
+// Tool Creation Functions
+// =============================================================================
+/**
+ * Calculate correlation coefficient
+ */
+export function createCorrelationTool(adapter) {
+    return {
+        name: 'mysql_stats_correlation',
+        title: 'MySQL Correlation',
+        description: 'Calculate Pearson correlation coefficient between two numeric columns.',
+        group: 'stats',
+        inputSchema: CorrelationSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column1, column2, where } = CorrelationSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(column1) || !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(column2)) {
+                throw new Error('Invalid column name');
+            }
+            const whereClause = where ? `WHERE ${where}` : '';
+            // Calculate Pearson correlation coefficient
+            const query = `
+                SELECT 
+                    (COUNT(*) * SUM(\`${column1}\` * \`${column2}\`) - SUM(\`${column1}\`) * SUM(\`${column2}\`)) /
+                    (SQRT(COUNT(*) * SUM(\`${column1}\` * \`${column1}\`) - SUM(\`${column1}\`) * SUM(\`${column1}\`)) *
+                     SQRT(COUNT(*) * SUM(\`${column2}\` * \`${column2}\`) - SUM(\`${column2}\`) * SUM(\`${column2}\`))) 
+                    as correlation,
+                    COUNT(*) as sample_size,
+                    AVG(\`${column1}\`) as mean_x,
+                    AVG(\`${column2}\`) as mean_y,
+                    STD(\`${column1}\`) as std_x,
+                    STD(\`${column2}\`) as std_y
+                FROM \`${table}\`
+                ${whereClause}
+            `;
+            const result = await adapter.executeQuery(query);
+            const stats = result.rows?.[0];
+            const correlation = stats?.['correlation'];
+            let interpretation = 'N/A';
+            if (correlation !== null) {
+                const absCorr = Math.abs(correlation);
+                if (absCorr >= 0.9)
+                    interpretation = 'Very strong';
+                else if (absCorr >= 0.7)
+                    interpretation = 'Strong';
+                else if (absCorr >= 0.5)
+                    interpretation = 'Moderate';
+                else if (absCorr >= 0.3)
+                    interpretation = 'Weak';
+                else
+                    interpretation = 'Very weak / No correlation';
+            }
+            return {
+                column1,
+                column2,
+                correlation: correlation ?? null,
+                interpretation,
+                sampleSize: stats?.['sample_size'] ?? 0,
+                column1Stats: {
+                    mean: stats?.['mean_x'] ?? null,
+                    stddev: stats?.['std_x'] ?? null
+                },
+                column2Stats: {
+                    mean: stats?.['mean_y'] ?? null,
+                    stddev: stats?.['std_y'] ?? null
+                }
+            };
+        }
+    };
+}
+/**
+ * Linear regression analysis
+ */
+export function createRegressionTool(adapter) {
+    return {
+        name: 'mysql_stats_regression',
+        title: 'MySQL Linear Regression',
+        description: 'Perform simple linear regression analysis (y = mx + b) between two columns.',
+        group: 'stats',
+        inputSchema: RegressionSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, xColumn, yColumn, where } = RegressionSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(xColumn) || !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(yColumn)) {
+                throw new Error('Invalid column name');
+            }
+            const whereClause = where ? `WHERE ${where}` : '';
+            // Simpler approach for MySQL
+            const statsQuery = `
+                SELECT 
+                    COUNT(*) as n,
+                    AVG(\`${xColumn}\`) as avg_x,
+                    AVG(\`${yColumn}\`) as avg_y,
+                    SUM(\`${xColumn}\` * \`${xColumn}\`) as sum_x2,
+                    SUM(\`${yColumn}\` * \`${yColumn}\`) as sum_y2,
+                    SUM(\`${xColumn}\` * \`${yColumn}\`) as sum_xy,
+                    SUM(\`${xColumn}\`) as sum_x,
+                    SUM(\`${yColumn}\`) as sum_y
+                FROM \`${table}\`
+                ${whereClause}
+            `;
+            const result = await adapter.executeQuery(statsQuery);
+            const stats = result.rows?.[0];
+            if (!stats || stats['n'] < 2) {
+                return {
+                    error: 'Insufficient data points for regression (need at least 2)',
+                    sampleSize: stats?.['n'] ?? 0
+                };
+            }
+            const n = stats['n'];
+            const sumX = stats['sum_x'];
+            const sumY = stats['sum_y'];
+            const sumXY = stats['sum_xy'];
+            const sumX2 = stats['sum_x2'];
+            const sumY2 = stats['sum_y2'];
+            // Calculate slope and intercept
+            const slope = (n * sumXY - sumX * sumY) / (n * sumX2 - sumX * sumX);
+            const intercept = (sumY - slope * sumX) / n;
+            // Calculate R-squared
+            const ssTotal = sumY2 - (sumY * sumY) / n;
+            const ssResidual = sumY2 - intercept * sumY - slope * sumXY;
+            const rSquared = ssTotal > 0 ? 1 - (ssResidual / ssTotal) : 0;
+            return {
+                xColumn,
+                yColumn,
+                sampleSize: n,
+                slope: isNaN(slope) ? null : slope,
+                intercept: isNaN(intercept) ? null : intercept,
+                rSquared: isNaN(rSquared) ? null : rSquared,
+                equation: isNaN(slope) ? null : `y = ${slope.toFixed(4)}x + ${intercept.toFixed(4)}`,
+                interpretation: rSquared >= 0.7 ? 'Good fit' : rSquared >= 0.5 ? 'Moderate fit' : 'Poor fit'
+            };
+        }
+    };
+}
+/**
+ * Column histogram management
+ */
+export function createHistogramTool(adapter) {
+    return {
+        name: 'mysql_stats_histogram',
+        title: 'MySQL Histogram Statistics',
+        description: 'View or update column histogram statistics (MySQL 8.0+).',
+        group: 'stats',
+        inputSchema: HistogramSchema,
+        requiredScopes: ['read'], // read for view, admin for update
+        annotations: {
+            readOnlyHint: false // Can update histogram
+        },
+        handler: async (params, _context) => {
+            const { table, column, buckets, update } = HistogramSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(column)) {
+                throw new Error('Invalid column name');
+            }
+            if (update) {
+                // Create or update histogram
+                const numBuckets = Math.min(buckets, 1024);
+                await adapter.executeQuery(`ANALYZE TABLE \`${table}\` UPDATE HISTOGRAM ON \`${column}\` WITH ${String(numBuckets)} BUCKETS`);
+            }
+            // Get histogram info from information_schema
+            const histogramQuery = `
+                SELECT 
+                    SCHEMA_NAME as schemaName,
+                    TABLE_NAME as tableName,
+                    COLUMN_NAME as columnName,
+                    JSON_EXTRACT(HISTOGRAM, '$."histogram-type"') as histogramType,
+                    JSON_EXTRACT(HISTOGRAM, '$."number-of-buckets-specified"') as bucketsSpecified,
+                    JSON_EXTRACT(HISTOGRAM, '$."sampling-rate"') as samplingRate,
+                    JSON_EXTRACT(HISTOGRAM, '$."last-updated"') as lastUpdated,
+                    JSON_LENGTH(JSON_EXTRACT(HISTOGRAM, '$.buckets')) as actualBuckets
+                FROM information_schema.COLUMN_STATISTICS
+                WHERE TABLE_NAME = ?
+                  AND COLUMN_NAME = ?
+                  AND SCHEMA_NAME = DATABASE()
+            `;
+            const result = await adapter.executeQuery(histogramQuery, [table, column]);
+            if (!result.rows || result.rows.length === 0) {
+                return {
+                    exists: false,
+                    message: update
+                        ? 'Histogram created but not yet visible in metadata'
+                        : 'No histogram exists for this column',
+                    table,
+                    column
+                };
+            }
+            const histogramRow = result.rows[0];
+            if (!histogramRow) {
+                return { exists: false, table, column };
+            }
+            return {
+                exists: true,
+                ...histogramRow,
+                updated: update
+            };
+        }
+    };
+}
+//# sourceMappingURL=comparative.js.map

package/dist/adapters/mysql/tools/stats/comparative.js.map

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

package/dist/adapters/mysql/tools/stats/descriptive.d.ts

@@ -0,0 +1,30 @@
+/**
+ * MySQL Descriptive Statistics Tools
+ *
+ * Tools for basic statistical analysis: descriptive stats, percentiles,
+ * distribution, time series, and sampling.
+ * 5 tools total.
+ */
+import type { MySQLAdapter } from '../../MySQLAdapter.js';
+import type { ToolDefinition } from '../../../../types/index.js';
+/**
+ * Calculate descriptive statistics
+ */
+export declare function createDescriptiveStatsTool(adapter: MySQLAdapter): ToolDefinition;
+/**
+ * Calculate percentiles
+ */
+export declare function createPercentilesTool(adapter: MySQLAdapter): ToolDefinition;
+/**
+ * Analyze data distribution
+ */
+export declare function createDistributionTool(adapter: MySQLAdapter): ToolDefinition;
+/**
+ * Time series analysis with moving averages
+ */
+export declare function createTimeSeriesToolStats(adapter: MySQLAdapter): ToolDefinition;
+/**
+ * Random sampling
+ */
+export declare function createSamplingTool(adapter: MySQLAdapter): ToolDefinition;
+//# sourceMappingURL=descriptive.d.ts.map

package/dist/adapters/mysql/tools/stats/descriptive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptive.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/stats/descriptive.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,4BAA4B,CAAC;AAgDjF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAkGhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAgE3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAqF5E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA6D/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA8DxE"}