@neverinfamous/mysql-mcp 2.1.0

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

@@ -0,0 +1,113 @@
+export function createSetupMysqlshPrompt() {
+    return {
+        name: 'mysql_setup_shell',
+        description: 'MySQL Shell setup and usage guide',
+        arguments: [],
+        handler: (_args, _context) => {
+            return Promise.resolve(`# MySQL Shell Setup Guide
+
+MySQL Shell is an advanced client with JavaScript, Python, and SQL modes, plus powerful dump/load utilities.
+
+## Step 1: Verify Installation
+
+Use \`mysqlsh_version\` tool to check if MySQL Shell is installed:
+- Requires MySQL Shell 8.0+
+- Should be in PATH or configured via MYSQLSH_PATH
+
+## Step 2: Configure Environment
+
+Set environment variables for MCP server:
+\`\`\`bash
+# Path to mysqlsh binary (if not in PATH)
+MYSQLSH_PATH=/usr/bin/mysqlsh
+
+# Working directory for dump/load operations
+MYSQLSH_WORK_DIR=/tmp/mysql-dumps
+
+# Timeout for shell commands (ms, default: 300000 = 5 min)
+MYSQLSH_TIMEOUT=300000
+\`\`\`
+
+## Step 3: Basic MySQL Shell Usage
+
+### SQL Mode
+\`\`\`bash
+mysqlsh --sql mysql://user:pass@localhost/dbname
+\`\`\`
+
+### JavaScript Mode
+\`\`\`bash
+mysqlsh --js mysql://user:pass@localhost
+\\js session.runSql("SELECT 1")
+\`\`\`
+
+### Python Mode
+\`\`\`bash
+mysqlsh --py mysql://user:pass@localhost
+\\py session.run_sql("SELECT 1")
+\`\`\`
+
+## Step 4: Available MCP Tools
+
+### Version and Upgrade Check
+- \`mysqlsh_version\` - Check Shell version
+- \`mysqlsh_check_upgrade\` - Check MySQL server upgrade compatibility
+
+### Data Export
+- \`mysqlsh_export_table\` - Export table to CSV/TSV/JSON
+- \`mysqlsh_dump_instance\` - Dump entire instance (parallel, fast)
+- \`mysqlsh_dump_schemas\` - Dump specific schemas
+- \`mysqlsh_dump_tables\` - Dump specific tables
+
+### Data Import
+- \`mysqlsh_import_table\` - Parallel table import
+- \`mysqlsh_import_json\` - Import JSON documents
+- \`mysqlsh_load_dump\` - Load MySQL Shell dump
+
+### Scripting
+- \`mysqlsh_run_script\` - Execute JS/Python/SQL script
+
+## Step 5: Common Workflows
+
+### Fast Instance Backup
+\`\`\`
+Use mysqlsh_dump_instance tool:
+- 10-20x faster than mysqldump
+- Parallel execution
+- Consistent snapshot
+\`\`\`
+
+### Large Table Import
+\`\`\`
+Use mysqlsh_import_table tool:
+- Parallel chunk loading
+- Automatic transaction management
+- Progress reporting
+\`\`\`
+
+### Schema Migration
+\`\`\`
+1. Check upgrade compatibility: mysqlsh_check_upgrade
+2. Dump source: mysqlsh_dump_instance
+3. Load to target: mysqlsh_load_dump
+\`\`\`
+
+## Step 6: Best Practices
+
+1. **Use dump utilities for large databases** - Much faster than mysqldump
+2. **Set appropriate work directory** - Ensure enough disk space
+3. **Adjust timeout for large operations** - Dumps may take hours
+4. **Use compression** - Reduces storage and transfer time
+
+## Troubleshooting
+
+- **mysqlsh not found**: Set MYSQLSH_PATH
+- **Permission denied**: Check work directory permissions
+- **Timeout**: Increase MYSQLSH_TIMEOUT for large operations
+- **Connection errors**: Verify MySQL connection string
+
+Start by running \`mysqlsh_version\` to verify installation.`);
+        }
+    };
+}
+//# sourceMappingURL=mysqlshSetup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mysqlshSetup.js","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/mysqlshSetup.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,wBAAwB;IACpC,OAAO;QACH,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,mCAAmC;QAChD,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,CAAC,KAA6B,EAAE,QAAwB,EAAE,EAAE;YACjE,OAAO,OAAO,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DAsG0B,CAAC,CAAC;QACvD,CAAC;KACJ,CAAC;AACN,CAAC"}

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

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

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

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

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

@@ -0,0 +1,109 @@
+export function createSetupProxysqlPrompt() {
+    return {
+        name: 'mysql_setup_proxysql',
+        description: 'Complete ProxySQL setup and configuration guide',
+        arguments: [],
+        handler: (_args, _context) => {
+            return Promise.resolve(`# ProxySQL Setup Guide
+
+ProxySQL is a high-performance MySQL proxy supporting connection pooling, query routing, and caching.
+
+## Prerequisites
+
+1. **ProxySQL installed** (v2.x recommended)
+2. **MySQL backend servers** accessible
+3. **Admin access** to ProxySQL (default: admin:admin on port 6032)
+
+## Step 1: Connect to ProxySQL Admin
+
+\`\`\`bash
+mysql -h 127.0.0.1 -P 6032 -u admin -padmin
+\`\`\`
+
+## Step 2: Configure Backend Servers
+
+\`\`\`sql
+-- Add primary server (hostgroup 0 = writers)
+INSERT INTO mysql_servers (hostgroup_id, hostname, port, weight)
+VALUES (0, 'primary-host', 3306, 1000);
+
+-- Add replica servers (hostgroup 1 = readers)
+INSERT INTO mysql_servers (hostgroup_id, hostname, port, weight)
+VALUES (1, 'replica1-host', 3306, 500),
+       (1, 'replica2-host', 3306, 500);
+
+-- Load and save configuration
+LOAD MYSQL SERVERS TO RUNTIME;
+SAVE MYSQL SERVERS TO DISK;
+\`\`\`
+
+## Step 3: Configure Users
+
+\`\`\`sql
+-- Add MySQL users that will connect through ProxySQL
+INSERT INTO mysql_users (username, password, default_hostgroup)
+VALUES ('app_user', 'password', 0);
+
+LOAD MYSQL USERS TO RUNTIME;
+SAVE MYSQL USERS TO DISK;
+\`\`\`
+
+## Step 4: Configure Query Rules
+
+\`\`\`sql
+-- Route SELECT queries to readers (hostgroup 1)
+INSERT INTO mysql_query_rules (rule_id, active, match_pattern, destination_hostgroup)
+VALUES (1, 1, '^SELECT.*FOR UPDATE', 0),      -- SELECT FOR UPDATE to writers
+       (2, 1, '^SELECT', 1);                   -- Other SELECTs to readers
+
+LOAD MYSQL QUERY RULES TO RUNTIME;
+SAVE MYSQL QUERY RULES TO DISK;
+\`\`\`
+
+## Step 5: Configure MCP Server
+
+Set environment variables:
+\`\`\`bash
+PROXYSQL_HOST=localhost
+PROXYSQL_PORT=6032
+PROXYSQL_USER=admin
+PROXYSQL_PASSWORD=admin
+\`\`\`
+
+## Step 6: Verify with MCP Tools
+
+Use ProxySQL tools to verify:
+- \`proxysql_status\` - Check ProxySQL is running
+- \`proxysql_servers\` - List configured servers
+- \`proxysql_hostgroups\` - View hostgroup configuration
+- \`proxysql_query_rules\` - Review routing rules
+- \`proxysql_query_digest\` - Analyze query patterns
+
+## Connection Pooling
+
+ProxySQL provides connection multiplexing:
+\`\`\`sql
+-- Configure max connections per hostgroup
+UPDATE mysql_servers SET max_connections = 100;
+LOAD MYSQL SERVERS TO RUNTIME;
+\`\`\`
+
+## Monitoring Queries
+
+Use \`proxysql_query_digest\` to find:
+- Slow queries
+- Most frequent queries
+- Queries for caching candidates
+
+## Best Practices
+
+1. **Connection pooling**: Set max_connections appropriately
+2. **Query caching**: Cache read-heavy, stable queries
+3. **Health checks**: Configure proper health check intervals
+4. **Monitor**: Watch query digest for performance issues
+
+Start by checking ProxySQL connection with \`proxysql_status\`.`);
+        }
+    };
+}
+//# sourceMappingURL=proxysqlSetup.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,140 @@
+export function createSetupReplicationPrompt() {
+    return {
+        name: 'mysql_setup_replication',
+        description: 'MySQL replication setup and configuration guide',
+        arguments: [
+            { name: 'type', description: 'Replication type: async, semisync, group', required: false }
+        ],
+        handler: (args, _context) => {
+            const replicationType = args['type'] ?? 'async';
+            return Promise.resolve(`# MySQL Replication Setup Guide
+
+Configure MySQL replication for high availability and read scaling.
+
+**Replication Type:** ${replicationType}
+
+## Step 1: Check Current Replication Status
+
+Use \`mysql://replication\` resource to check:
+- Current role (source/replica/standalone)
+- Binary log configuration
+- GTID status
+
+## Step 2: Prepare Source Server
+
+### Enable Binary Logging
+\`\`\`ini
+# my.cnf on source
+[mysqld]
+server-id = 1
+log_bin = mysql-bin
+binlog_format = ROW
+gtid_mode = ON
+enforce_gtid_consistency = ON
+\`\`\`
+
+### Create Replication User
+\`\`\`sql
+CREATE USER 'repl'@'%' IDENTIFIED BY 'replication_password';
+GRANT REPLICATION SLAVE ON *.* TO 'repl'@'%';
+\`\`\`
+
+## Step 3: Prepare Replica Server
+
+### Configure Replica
+\`\`\`ini
+# my.cnf on replica
+[mysqld]
+server-id = 2
+log_bin = mysql-bin
+relay_log = relay-bin
+gtid_mode = ON
+enforce_gtid_consistency = ON
+read_only = ON
+super_read_only = ON
+${replicationType === 'semisync' ? `
+# Semi-synchronous replication
+rpl_semi_sync_replica_enabled = 1` : ''}
+\`\`\`
+
+## Step 4: Initialize Replica
+
+### Option A: GTID-based (Recommended)
+\`\`\`sql
+CHANGE REPLICATION SOURCE TO
+    SOURCE_HOST = 'source-host',
+    SOURCE_PORT = 3306,
+    SOURCE_USER = 'repl',
+    SOURCE_PASSWORD = 'replication_password',
+    SOURCE_AUTO_POSITION = 1;
+
+START REPLICA;
+\`\`\`
+
+### Option B: Binary Log Position
+\`\`\`sql
+-- Get position from source
+SHOW BINARY LOG STATUS;
+
+-- On replica
+CHANGE REPLICATION SOURCE TO
+    SOURCE_HOST = 'source-host',
+    SOURCE_PORT = 3306,
+    SOURCE_USER = 'repl',
+    SOURCE_PASSWORD = 'replication_password',
+    SOURCE_LOG_FILE = 'mysql-bin.000001',
+    SOURCE_LOG_POS = 123456;
+
+START REPLICA;
+\`\`\`
+
+## Step 5: Verify Replication
+
+Use these tools to verify:
+- \`mysql_replication_status\` - Detailed status
+- \`mysql_replication_lag\` - Check replication delay
+- \`mysql://replication\` - Overall status
+
+\`\`\`sql
+SHOW REPLICA STATUS\\G
+\`\`\`
+
+Key things to check:
+- Replica_IO_Running: Yes
+- Replica_SQL_Running: Yes
+- Seconds_Behind_Source: 0 (or low)
+
+## Semi-Synchronous Replication
+
+For reduced data loss risk:
+\`\`\`sql
+-- On source
+INSTALL PLUGIN rpl_semi_sync_source SONAME 'semisync_source.so';
+SET GLOBAL rpl_semi_sync_source_enabled = 1;
+
+-- On replica
+INSTALL PLUGIN rpl_semi_sync_replica SONAME 'semisync_replica.so';
+SET GLOBAL rpl_semi_sync_replica_enabled = 1;
+\`\`\`
+
+## Monitoring
+
+Regular monitoring should include:
+- Replication lag trends
+- Binary log volume
+- Error log for replication errors
+- GTID gaps
+
+## Failover Procedure
+
+1. Verify replica is caught up
+2. Stop replication on replica
+3. Promote replica: \`SET GLOBAL read_only = OFF;\`
+4. Update application connection strings
+5. Re-point other replicas to new source
+
+Start by checking current replication status with \`mysql://replication\`.`);
+        }
+    };
+}
+//# sourceMappingURL=replicationSetup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replicationSetup.js","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/replicationSetup.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,4BAA4B;IACxC,OAAO;QACH,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,iDAAiD;QAC9D,SAAS,EAAE;YACP,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0CAA0C,EAAE,QAAQ,EAAE,KAAK,EAAE;SAC7F;QACD,OAAO,EAAE,CAAC,IAA4B,EAAE,QAAwB,EAAE,EAAE;YAChE,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC;YAEhD,OAAO,OAAO,CAAC,OAAO,CAAC;;;;wBAIX,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCrC,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC;;kCAED,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2EA+EoC,CAAC,CAAC;QACrE,CAAC;KACJ,CAAC;AACN,CAAC"}

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

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

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

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

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

@@ -0,0 +1,100 @@
+export function createSetupRouterPrompt() {
+    return {
+        name: 'mysql_setup_router',
+        description: 'Complete MySQL Router setup and configuration guide',
+        arguments: [],
+        handler: (_args, _context) => {
+            return Promise.resolve(`# MySQL Router Setup Guide
+
+MySQL Router provides transparent routing between applications and MySQL servers, supporting InnoDB Cluster for high availability.
+
+## Prerequisites
+
+1. **MySQL Router installed** (comes with MySQL 8.0+)
+2. **InnoDB Cluster** (optional but recommended for HA)
+3. **Admin credentials** for MySQL servers
+
+## Step 1: Bootstrap Router (InnoDB Cluster)
+
+If using InnoDB Cluster:
+\`\`\`bash
+mysqlrouter --bootstrap admin@primary-host:3306 --user=mysqlrouter
+\`\`\`
+
+This auto-configures Router to work with your cluster.
+
+## Step 2: Manual Configuration
+
+For manual setup, edit \`mysqlrouter.conf\`:
+\`\`\`ini
+[routing:primary]
+bind_address = 0.0.0.0
+bind_port = 6446
+destinations = primary-host:3306
+routing_strategy = first-available
+mode = read-write
+
+[routing:secondary]
+bind_address = 0.0.0.0
+bind_port = 6447
+destinations = secondary1:3306,secondary2:3306
+routing_strategy = round-robin
+mode = read-only
+\`\`\`
+
+## Step 3: Enable REST API (for monitoring)
+
+Add to mysqlrouter.conf:
+\`\`\`ini
+[rest_api]
+require_realm = default_realm
+
+[rest_router]
+require_realm = default_realm
+
+[rest_metadata_cache]
+require_realm = default_realm
+
+[http_server]
+port = 8443
+ssl = 1
+ssl_cert = /path/to/router-cert.pem
+ssl_key = /path/to/router-key.pem
+\`\`\`
+
+## Step 4: Configure MCP Server
+
+Set environment variables:
+\`\`\`bash
+MYSQL_ROUTER_URL=https://localhost:8443
+MYSQL_ROUTER_USERNAME=admin
+MYSQL_ROUTER_PASSWORD=your_password
+MYSQL_ROUTER_INSECURE=true  # For self-signed certs
+\`\`\`
+
+## Step 5: Verify with MCP Tools
+
+Use Router tools to verify:
+- \`mysql_router_status\` - Check Router is running
+- \`mysql_router_routes\` - List configured routes
+- \`mysql_router_route_health\` - Check route health
+
+## Routing Strategies
+
+| Strategy | Description | Use Case |
+|----------|-------------|----------|
+| first-available | Routes to first healthy server | Primary writes |
+| round-robin | Distributes across all servers | Read scaling |
+| round-robin-with-fallback | Round-robin with fallback | HA reads |
+
+## Common Issues
+
+1. **Connection refused**: Check Router is running and ports are open
+2. **SSL errors**: Use MYSQL_ROUTER_INSECURE=true for self-signed certs
+3. **No destinations**: Verify backend servers are healthy
+
+Start by checking if MySQL Router is installed and running.`);
+        }
+    };
+}
+//# sourceMappingURL=routerSetup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routerSetup.js","sourceRoot":"","sources":["../../../../src/adapters/mysql/prompts/routerSetup.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,uBAAuB;IACnC,OAAO;QACH,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,qDAAqD;QAClE,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,CAAC,KAA6B,EAAE,QAAwB,EAAE,EAAE;YACjE,OAAO,OAAO,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4DAyFyB,CAAC,CAAC;QACtD,CAAC;KACJ,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * MySQL Prompt - Spatial/GIS Setup
+ *
+ * Complete Spatial data and GIS setup guide.
+ */
+import type { PromptDefinition } from '../../../types/index.js';
+export declare function createSetupSpatialPrompt(): PromptDefinition;
+//# sourceMappingURL=spatialSetup.d.ts.map

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

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

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

@@ -0,0 +1,103 @@
+export function createSetupSpatialPrompt() {
+    return {
+        name: 'mysql_setup_spatial',
+        description: 'Complete MySQL Spatial/GIS setup and usage guide',
+        arguments: [],
+        handler: (_args, _context) => {
+            return Promise.resolve(`# MySQL Spatial/GIS Setup Guide
+
+MySQL provides native spatial data support with geometry types and spatial functions (ST_*).
+
+## Prerequisites
+
+1. **MySQL 5.7+** for full spatial support
+2. **MySQL 8.0+** for proper SRID enforcement
+3. **InnoDB engine** for spatial indexes
+
+## Step 1: Create Spatial Columns
+
+\`\`\`sql
+CREATE TABLE locations (
+    id INT PRIMARY KEY AUTO_INCREMENT,
+    name VARCHAR(100),
+    location POINT NOT NULL SRID 4326,
+    boundary POLYGON SRID 4326,
+    SPATIAL INDEX (location)
+);
+\`\`\`
+
+## Step 2: Insert Spatial Data
+
+\`\`\`sql
+-- Using WKT (Well-Known Text)
+INSERT INTO locations (name, location) VALUES
+('Office', ST_GeomFromText('POINT(40.7484 -73.9857)', 4326));
+
+-- Using GeoJSON
+INSERT INTO locations (name, location) VALUES
+('Store', ST_GeomFromGeoJSON('{"type":"Point","coordinates":[-73.9857,40.7484]}'));
+\`\`\`
+
+## Step 3: Query Spatial Data
+
+\`\`\`sql
+-- Find points within distance (meters for SRID 4326)
+SELECT name, ST_Distance_Sphere(
+    location,
+    ST_GeomFromText('POINT(40.7128 -74.0060)', 4326)
+) AS distance_meters
+FROM locations
+ORDER BY distance_meters
+LIMIT 10;
+
+-- Points within polygon
+SELECT * FROM locations
+WHERE ST_Contains(
+    ST_GeomFromText('POLYGON((...))'),
+    location
+);
+\`\`\`
+
+## Common SRIDs
+
+| SRID | Name | Use Case |
+|------|------|----------|
+| 4326 | WGS 84 | GPS coordinates (lon/lat) |
+| 3857 | Web Mercator | Web maps |
+| 0 | Planar | Local/metric calculations |
+
+## Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| \`mysql_spatial_create_column\` | Add geometry column |
+| \`mysql_spatial_create_index\` | Create SPATIAL index |
+| \`mysql_spatial_point\` | Create POINT geometry |
+| \`mysql_spatial_polygon\` | Create POLYGON geometry |
+| \`mysql_spatial_distance\` | Calculate distance |
+| \`mysql_spatial_distance_sphere\` | Spherical distance |
+| \`mysql_spatial_contains\` | ST_Contains check |
+| \`mysql_spatial_within\` | ST_Within check |
+| \`mysql_spatial_intersection\` | Find intersection |
+| \`mysql_spatial_buffer\` | Create buffer zone |
+| \`mysql_spatial_transform\` | Transform SRID |
+| \`mysql_spatial_geojson\` | Convert GeoJSON |
+
+## Best Practices
+
+1. **Always specify SRID** for geographic data
+2. **Use SRID 4326** for GPS/lon-lat coordinates
+3. **Index spatial columns** for query performance
+4. **Use ST_Distance_Sphere** for earth distance calculations
+
+## Common Issues
+
+1. **SRID mismatch**: Ensure all geometries use same SRID
+2. **Coordinate order**: MySQL 8.0+ with SRID 4326 uses (X, Y) = (latitude, longitude) per EPSG standard
+3. **Index not used**: Check column is NOT NULL
+
+Start by creating a spatial column with \`mysql_spatial_create_column\`.`);
+        }
+    };
+}
+//# sourceMappingURL=spatialSetup.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * MySQL Prompt - sys Schema Guide
+ *
+ * Complete sys schema usage guide for diagnostics.
+ */
+import type { PromptDefinition } from '../../../types/index.js';
+export declare function createSysSchemaGuidePrompt(): PromptDefinition;
+//# sourceMappingURL=sysSchema.d.ts.map

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

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