@neverinfamous/mysql-mcp 2.1.0 → 2.3.0

package/src/adapters/mysql/prompts/indexTuning.ts

@@ -1,23 +1,28 @@
 /**
  * MySQL Prompt - Index Tuning
- * 
+ *
  * Index analysis and optimization workflow.
  */
-import type { PromptDefinition, RequestContext } from '../../../types/index.js';
+import type { PromptDefinition, RequestContext } from "../../../types/index.js";
 
 export function createIndexTuningPrompt(): PromptDefinition {
-    return {
-        name: 'mysql_index_tuning',
-        description: 'Analyze and optimize database indexes',
-        arguments: [
-            { name: 'table', description: 'Specific table to analyze (optional, analyzes all if not provided)', required: false }
-        ],
-        handler: (args: Record<string, string>, _context: RequestContext) => {
-            const table = args['table'];
-
-            return Promise.resolve(`# MySQL Index Tuning Workflow
-
-${table ? `Analyze and optimize indexes for table: **${table}**` : 'Analyze and optimize indexes across the database'}
+  return {
+    name: "mysql_index_tuning",
+    description: "Analyze and optimize database indexes",
+    arguments: [
+      {
+        name: "table",
+        description:
+          "Specific table to analyze (optional, analyzes all if not provided)",
+        required: false,
+      },
+    ],
+    handler: (args: Record<string, string>, _context: RequestContext) => {
+      const table = args["table"];
+
+      return Promise.resolve(`# MySQL Index Tuning Workflow
+
+${table ? `Analyze and optimize indexes for table: **${table}**` : "Analyze and optimize indexes across the database"}
 
 ## Step 1: Identify Index Issues
 
@@ -84,7 +89,7 @@ After changes:
 2. Compare query execution times
 3. Monitor \`mysql://performance\` for improvements
 
-${table ? `\nStart by analyzing indexes on table **${table}**.` : '\nStart by reviewing the `mysql://indexes` resource.'}`);
-        }
-    };
+${table ? `\nStart by analyzing indexes on table **${table}**.` : "\nStart by reviewing the `mysql://indexes` resource."}`);
+    },
+  };
 }

package/src/adapters/mysql/prompts/mysqlshSetup.ts

@@ -1,17 +1,17 @@
 /**
  * MySQL Prompt - MySQL Shell Setup
- * 
+ *
  * MySQL Shell installation and usage guide.
  */
-import type { PromptDefinition, RequestContext } from '../../../types/index.js';
+import type { PromptDefinition, RequestContext } from "../../../types/index.js";
 
 export function createSetupMysqlshPrompt(): PromptDefinition {
-    return {
-        name: 'mysql_setup_shell',
-        description: 'MySQL Shell setup and usage guide',
-        arguments: [],
-        handler: (_args: Record<string, string>, _context: RequestContext) => {
-            return Promise.resolve(`# MySQL Shell Setup Guide
+  return {
+    name: "mysql_setup_shell",
+    description: "MySQL Shell setup and usage guide",
+    arguments: [],
+    handler: (_args: Record<string, string>, _context: RequestContext) => {
+      return Promise.resolve(`# MySQL Shell Setup Guide
 
 MySQL Shell is an advanced client with JavaScript, Python, and SQL modes, plus powerful dump/load utilities.
 
@@ -61,7 +61,7 @@ mysqlsh --py mysql://user:pass@localhost
 - \`mysqlsh_check_upgrade\` - Check MySQL server upgrade compatibility
 
 ### Data Export
-- \`mysqlsh_export_table\` - Export table to CSV/TSV/JSON
+- \`mysqlsh_export_table\` - Export table to CSV/TSV
 - \`mysqlsh_dump_instance\` - Dump entire instance (parallel, fast)
 - \`mysqlsh_dump_schemas\` - Dump specific schemas
 - \`mysqlsh_dump_tables\` - Dump specific tables
@@ -114,6 +114,6 @@ Use mysqlsh_import_table tool:
 - **Connection errors**: Verify MySQL connection string
 
 Start by running \`mysqlsh_version\` to verify installation.`);
-        }
-    };
+    },
+  };
 }

package/src/adapters/mysql/prompts/proxysqlSetup.ts

@@ -1,17 +1,17 @@
 /**
  * MySQL Prompt - ProxySQL Setup
- * 
+ *
  * Complete ProxySQL configuration guide.
  */
-import type { PromptDefinition, RequestContext } from '../../../types/index.js';
+import type { PromptDefinition, RequestContext } from "../../../types/index.js";
 
 export function createSetupProxysqlPrompt(): PromptDefinition {
-    return {
-        name: 'mysql_setup_proxysql',
-        description: 'Complete ProxySQL setup and configuration guide',
-        arguments: [],
-        handler: (_args: Record<string, string>, _context: RequestContext) => {
-            return Promise.resolve(`# ProxySQL Setup Guide
+  return {
+    name: "mysql_setup_proxysql",
+    description: "Complete ProxySQL setup and configuration guide",
+    arguments: [],
+    handler: (_args: Record<string, string>, _context: RequestContext) => {
+      return Promise.resolve(`# ProxySQL Setup Guide
 
 ProxySQL is a high-performance MySQL proxy supporting connection pooling, query routing, and caching.
 
@@ -110,6 +110,6 @@ Use \`proxysql_query_digest\` to find:
 4. **Monitor**: Watch query digest for performance issues
 
 Start by checking ProxySQL connection with \`proxysql_status\`.`);
-        }
-    };
+    },
+  };
 }

package/src/adapters/mysql/prompts/replicationSetup.ts

@@ -1,21 +1,25 @@
 /**
  * MySQL Prompt - Replication Setup
- * 
+ *
  * MySQL replication configuration guide.
  */
-import type { PromptDefinition, RequestContext } from '../../../types/index.js';
+import type { PromptDefinition, RequestContext } from "../../../types/index.js";
 
 export function createSetupReplicationPrompt(): PromptDefinition {
-    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: Record<string, string>, _context: RequestContext) => {
-            const replicationType = args['type'] ?? 'async';
-
-            return Promise.resolve(`# MySQL Replication Setup Guide
+  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: Record<string, string>, _context: RequestContext) => {
+      const replicationType = args["type"] ?? "async";
+
+      return Promise.resolve(`# MySQL Replication Setup Guide
 
 Configure MySQL replication for high availability and read scaling.
 
@@ -60,9 +64,13 @@ gtid_mode = ON
 enforce_gtid_consistency = ON
 read_only = ON
 super_read_only = ON
-${replicationType === 'semisync' ? `
+${
+  replicationType === "semisync"
+    ? `
 # Semi-synchronous replication
-rpl_semi_sync_replica_enabled = 1` : ''}
+rpl_semi_sync_replica_enabled = 1`
+    : ""
+}
 \`\`\`
 
 ## Step 4: Initialize Replica
@@ -142,6 +150,6 @@ Regular monitoring should include:
 5. Re-point other replicas to new source
 
 Start by checking current replication status with \`mysql://replication\`.`);
-        }
-    };
+    },
+  };
 }

package/src/adapters/mysql/prompts/routerSetup.ts

@@ -1,17 +1,17 @@
 /**
  * MySQL Prompt - Router Setup
- * 
+ *
  * Complete MySQL Router configuration guide.
  */
-import type { PromptDefinition, RequestContext } from '../../../types/index.js';
+import type { PromptDefinition, RequestContext } from "../../../types/index.js";
 
 export function createSetupRouterPrompt(): PromptDefinition {
-    return {
-        name: 'mysql_setup_router',
-        description: 'Complete MySQL Router setup and configuration guide',
-        arguments: [],
-        handler: (_args: Record<string, string>, _context: RequestContext) => {
-            return Promise.resolve(`# MySQL Router Setup Guide
+  return {
+    name: "mysql_setup_router",
+    description: "Complete MySQL Router setup and configuration guide",
+    arguments: [],
+    handler: (_args: Record<string, string>, _context: RequestContext) => {
+      return Promise.resolve(`# MySQL Router Setup Guide
 
 MySQL Router provides transparent routing between applications and MySQL servers, supporting InnoDB Cluster for high availability.
 
@@ -62,6 +62,9 @@ require_realm = default_realm
 [rest_metadata_cache]
 require_realm = default_realm
 
+[rest_connection_pool]
+require_realm = default_realm
+
 [http_server]
 port = 8443
 ssl = 1
@@ -69,6 +72,8 @@ ssl_cert = /path/to/router-cert.pem
 ssl_key = /path/to/router-key.pem
 \`\`\`
 
+> **Note**: \`mysql_router_pool_status\` also requires \`connection_sharing=1\` on at least one route.
+
 ## Step 4: Configure MCP Server
 
 Set environment variables:
@@ -101,6 +106,6 @@ Use Router tools to verify:
 3. **No destinations**: Verify backend servers are healthy
 
 Start by checking if MySQL Router is installed and running.`);
-        }
-    };
+    },
+  };
 }

package/src/adapters/mysql/prompts/spatialSetup.ts

@@ -1,17 +1,17 @@
 /**
  * MySQL Prompt - Spatial/GIS Setup
- * 
+ *
  * Complete Spatial data and GIS setup guide.
  */
-import type { PromptDefinition, RequestContext } from '../../../types/index.js';
+import type { PromptDefinition, RequestContext } from "../../../types/index.js";
 
 export function createSetupSpatialPrompt(): PromptDefinition {
-    return {
-        name: 'mysql_setup_spatial',
-        description: 'Complete MySQL Spatial/GIS setup and usage guide',
-        arguments: [],
-        handler: (_args: Record<string, string>, _context: RequestContext) => {
-            return Promise.resolve(`# MySQL Spatial/GIS Setup Guide
+  return {
+    name: "mysql_setup_spatial",
+    description: "Complete MySQL Spatial/GIS setup and usage guide",
+    arguments: [],
+    handler: (_args: Record<string, string>, _context: RequestContext) => {
+      return Promise.resolve(`# MySQL Spatial/GIS Setup Guide
 
 MySQL provides native spatial data support with geometry types and spatial functions (ST_*).
 
@@ -104,6 +104,6 @@ WHERE ST_Contains(
 3. **Index not used**: Check column is NOT NULL
 
 Start by creating a spatial column with \`mysql_spatial_create_column\`.`);
-        }
-    };
+    },
+  };
 }

package/src/adapters/mysql/prompts/sysSchema.ts

@@ -1,17 +1,18 @@
 /**
  * MySQL Prompt - sys Schema Guide
- * 
+ *
  * Complete sys schema usage guide for diagnostics.
  */
-import type { PromptDefinition, RequestContext } from '../../../types/index.js';
+import type { PromptDefinition, RequestContext } from "../../../types/index.js";
 
 export function createSysSchemaGuidePrompt(): PromptDefinition {
-    return {
-        name: 'mysql_sys_schema_guide',
-        description: 'Complete MySQL sys schema usage guide for diagnostics and troubleshooting',
-        arguments: [],
-        handler: (_args: Record<string, string>, _context: RequestContext) => {
-            return Promise.resolve(`# MySQL sys Schema Guide
+  return {
+    name: "mysql_sys_schema_guide",
+    description:
+      "Complete MySQL sys schema usage guide for diagnostics and troubleshooting",
+    arguments: [],
+    handler: (_args: Record<string, string>, _context: RequestContext) => {
+      return Promise.resolve(`# MySQL sys Schema Guide
 
 The sys schema provides human-readable views built on Performance Schema data for database diagnostics.
 
@@ -104,6 +105,6 @@ SELECT sys.format_statement('SELECT * FROM users WHERE id = 1');
 4. **Monitor performance_schema memory**
 
 Start by checking overall user activity with \`mysql_sys_user_summary\`.`);
-        }
-    };
+    },
+  };
 }

package/src/adapters/mysql/resources/__tests__/capabilities.test.ts

@@ -1,52 +1,123 @@
-
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { createCapabilitiesResource } from '../capabilities.js';
-import type { MySQLAdapter } from '../../MySQLAdapter.js';
-import { createMockMySQLAdapter, createMockRequestContext, createMockQueryResult } from '../../../../__tests__/mocks/index.js';
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { createCapabilitiesResource } from "../capabilities.js";
+import type { MySQLAdapter } from "../../MySQLAdapter.js";
+import {
+  createMockMySQLAdapter,
+  createMockRequestContext,
+  createMockQueryResult,
+} from "../../../../__tests__/mocks/index.js";
 
 interface CapabilitiesResult {
-    server: { version: string; features: { json: boolean; fulltext: boolean; partitioning: boolean } };
-    toolGroups: unknown[];
-    metaGroups: unknown[];
+  server: {
+    version: string;
+    features: {
+      json: boolean;
+      fulltext: boolean;
+      partitioning: boolean;
+      replication: boolean;
+      gtid: boolean;
+    };
+  };
+  toolGroups: unknown[];
+  metaGroups: unknown[];
 }
 
-describe('Capabilities Resource', () => {
-    let mockAdapter: ReturnType<typeof createMockMySQLAdapter>;
-    let mockContext: ReturnType<typeof createMockRequestContext>;
-
-    beforeEach(() => {
-        vi.clearAllMocks();
-        mockAdapter = createMockMySQLAdapter();
-        mockContext = createMockRequestContext();
-    });
-
-    it('should return server capabilities', async () => {
-        mockAdapter.executeQuery.mockResolvedValue(createMockQueryResult([{ version: '8.0.35' }]));
-
-        const resource = createCapabilitiesResource(mockAdapter as unknown as MySQLAdapter);
-        const result = await resource.handler('mysql://capabilities', mockContext) as CapabilitiesResult;
-
-        expect(result).toHaveProperty('server');
-        expect(result.server).toHaveProperty('version');
-        expect(result).toHaveProperty('toolGroups');
-        expect(result).toHaveProperty('metaGroups');
-    });
-
-    it('should include server features', async () => {
-        mockAdapter.executeQuery.mockResolvedValue(createMockQueryResult([{ version: '8.0.35' }]));
-
-        const resource = createCapabilitiesResource(mockAdapter as unknown as MySQLAdapter);
-        const result = await resource.handler('mysql://capabilities', mockContext) as CapabilitiesResult;
-
-        expect(result.server).toHaveProperty('features');
-        expect(result.server.features).toHaveProperty('json');
-        expect(result.server.features).toHaveProperty('fulltext');
-        expect(result.server.features).toHaveProperty('partitioning');
-    });
-
-    it('should have correct metadata', () => {
-        const resource = createCapabilitiesResource(mockAdapter as unknown as MySQLAdapter);
-        expect(resource.uri).toBe('mysql://capabilities');
-        expect(resource.mimeType).toBe('application/json');
-    });
+describe("Capabilities Resource", () => {
+  let mockAdapter: ReturnType<typeof createMockMySQLAdapter>;
+  let mockContext: ReturnType<typeof createMockRequestContext>;
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockAdapter = createMockMySQLAdapter();
+    mockContext = createMockRequestContext();
+  });
+
+  it("should return server capabilities", async () => {
+    mockAdapter.executeQuery.mockResolvedValue(
+      createMockQueryResult([{ version: "8.0.35" }]),
+    );
+
+    const resource = createCapabilitiesResource(
+      mockAdapter as unknown as MySQLAdapter,
+    );
+    const result = (await resource.handler(
+      "mysql://capabilities",
+      mockContext,
+    )) as CapabilitiesResult;
+
+    expect(result).toHaveProperty("server");
+    expect(result.server).toHaveProperty("version");
+    expect(result).toHaveProperty("toolGroups");
+    expect(result).toHaveProperty("metaGroups");
+  });
+
+  it("should include server features", async () => {
+    mockAdapter.executeQuery.mockResolvedValue(
+      createMockQueryResult([{ version: "8.0.35" }]),
+    );
+
+    const resource = createCapabilitiesResource(
+      mockAdapter as unknown as MySQLAdapter,
+    );
+    const result = (await resource.handler(
+      "mysql://capabilities",
+      mockContext,
+    )) as CapabilitiesResult;
+
+    expect(result.server).toHaveProperty("features");
+    expect(result.server.features).toHaveProperty("json");
+    expect(result.server.features).toHaveProperty("fulltext");
+    expect(result.server.features).toHaveProperty("partitioning");
+  });
+
+  it("should detect features correctly for MySQL 9.x", async () => {
+    mockAdapter.executeQuery.mockResolvedValue(
+      createMockQueryResult([{ version: "9.6.0" }]),
+    );
+
+    const resource = createCapabilitiesResource(
+      mockAdapter as unknown as MySQLAdapter,
+    );
+    const result = (await resource.handler(
+      "mysql://capabilities",
+      mockContext,
+    )) as CapabilitiesResult;
+
+    expect(result.server.version).toBe("9.6.0");
+    expect(result.server.features.json).toBe(true);
+    expect(result.server.features.gtid).toBe(true);
+    expect(result.server.features.fulltext).toBe(true);
+    expect(result.server.features.replication).toBe(true);
+    expect(result.server.features.partitioning).toBe(true);
+  });
+
+  it("should disable version-dependent features for unknown version", async () => {
+    mockAdapter.executeQuery.mockResolvedValue(
+      createMockQueryResult([{ version: "unknown" }]),
+    );
+
+    const resource = createCapabilitiesResource(
+      mockAdapter as unknown as MySQLAdapter,
+    );
+    const result = (await resource.handler(
+      "mysql://capabilities",
+      mockContext,
+    )) as CapabilitiesResult;
+
+    expect(result.server.version).toBe("unknown");
+    expect(result.server.features.json).toBe(false);
+    expect(result.server.features.gtid).toBe(false);
+    // Always-true features remain true
+    expect(result.server.features.fulltext).toBe(true);
+    expect(result.server.features.replication).toBe(true);
+    expect(result.server.features.partitioning).toBe(true);
+  });
+
+  it("should have correct metadata", () => {
+    const resource = createCapabilitiesResource(
+      mockAdapter as unknown as MySQLAdapter,
+    );
+    expect(resource.uri).toBe("mysql://capabilities");
+    expect(resource.mimeType).toBe("application/json");
+  });
 });