@arvoretech/mysql-mcp 1.0.0

package/README.md

@@ -0,0 +1,182 @@
+# MySQL MCP Server
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=mysql-mcp&registry=https://npm.pkg.github.com&packageName=@arvoretech/mysql-mcp)
+
+A Model Context Protocol (MCP) server implementation for MySQL that enables read-only database operations through a standardized protocol for integration with LLMs and AI tools.
+
+## Features
+
+- ✅ **Read-only**: Executes only SELECT, SHOW, DESCRIBE and EXPLAIN queries
+- 🔒 **Secure**: Validates queries to prevent write operations
+- 🚀 **Fast**: Direct MySQL connection using mysql2
+- 📡 **MCP Protocol**: Communication via stdio transport
+- 🛠️ **TypeScript**: Fully typed with Zod validation
+- 🌍 **Environment Configuration**: Easy setup via environment variables
+
+## Installation
+
+```bash
+npm install -g @arvoretech/mysql-mcp --registry=https://npm.pkg.github.com
+```
+
+Or configure your `.npmrc`:
+
+```bash
+echo "@arvoretech:registry=https://npm.pkg.github.com" >> ~/.npmrc
+npm install -g @arvoretech/mysql-mcp
+```
+
+## Configuration
+
+The server is configured via environment variables:
+
+```bash
+export MYSQL_HOST=localhost
+export MYSQL_PORT=3306
+export MYSQL_USER=root
+export MYSQL_PASSWORD=secret
+export MYSQL_DATABASE=mydb
+export MYSQL_SSL=false
+export MYSQL_CONNECTION_TIMEOUT=30000
+```
+
+## Usage
+
+```bash
+# Development
+pnpm dev
+
+# Production
+node dist/index.js
+```
+
+## Available MCP Tools
+
+### `read_query`
+
+Executes SELECT queries on the MySQL database.
+
+**Parameters:**
+
+- `query` (string): SQL SELECT statement
+
+**Example:**
+
+```json
+{
+  "query": "SELECT * FROM users LIMIT 10"
+}
+```
+
+### `list_tables`
+
+Lists all tables in the current database.
+
+**Parameters:** None
+
+### `describe_table`
+
+Gets structure and schema information for a specific table.
+
+**Parameters:**
+
+- `tableName` (string): Name of the table
+
+### `show_databases`
+
+Lists all available databases on the MySQL server.
+
+**Parameters:** None
+
+## Programmatic Usage
+
+```typescript
+import { MySQLMCPServer } from "mysql-mcp-server";
+
+const server = new MySQLMCPServer({
+  host: "localhost",
+  port: 3306,
+  user: "root",
+  password: "secret",
+  database: "mydb",
+  ssl: false,
+  connectionTimeout: 30000,
+});
+
+// Setup graceful shutdown
+server.setupGracefulShutdown();
+
+// Start server
+await server.start();
+```
+
+## Claude Desktop Integration
+
+Add to your Claude Desktop configuration file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@arvoretech/mysql-mcp"],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "root",
+        "MYSQL_PASSWORD": "secret",
+        "MYSQL_DATABASE": "mydb",
+        "MYSQL_SSL": "false",
+        "MYSQL_CONNECTION_TIMEOUT": "30000"
+      }
+    }
+  }
+}
+```
+
+## Security
+
+- **Query validation**: Only read operations are allowed
+- **Parameter escaping**: Uses prepared statements when possible
+- **Connection timeout**: Prevents hanging connections
+- **Error handling**: MySQL errors are caught and handled appropriately
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run in development mode
+pnpm dev
+
+# Build
+pnpm build
+
+# Linting
+pnpm lint
+pnpm lint:fix
+```
+
+## Architecture
+
+- **`MySQLConnection`**: Manages MySQL connection
+- **`MySQLMCPTools`**: Implements MCP tools
+- **`MySQLMCPServer`**: Main MCP server with stdio transport
+- **Validation**: Uses Zod for type and parameter validation
+
+## Connection Management
+
+The server uses a **connection-per-query** approach for optimal reliability:
+
+- **Fresh connections**: Each query opens and closes its own connection
+- **No persistent connections**: Prevents timeout and stale connection issues
+- **Automatic cleanup**: Connections are always properly closed after each operation
+- **Improved stability**: Eliminates bugs caused by long-running connections
+
+## Limitations
+
+- Read-only operations only (SELECT, SHOW, DESCRIBE, EXPLAIN)
+- Connection-per-query (no connection pooling)
+- MySQL only (not PostgreSQL, SQLite, etc.)
+- Stdio transport only (no HTTP/WebSocket)

package/dist/database.d.ts

@@ -0,0 +1,15 @@
+import { MySQLConfigInput, QueryResult, TableInfo, ColumnInfo, DatabaseInfo } from "./types.js";
+export declare class MySQLConnection {
+    private readonly config;
+    constructor(config: MySQLConfigInput);
+    private createConnection;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private validateReadOnlyQuery;
+    executeQuery(query: string): Promise<QueryResult>;
+    listTables(): Promise<TableInfo[]>;
+    describeTable(tableName: string): Promise<ColumnInfo[]>;
+    showDatabases(): Promise<DatabaseInfo[]>;
+    testConnection(): Promise<boolean>;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,gBAAgB,EAEhB,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,gBAAgB;YAItB,gBAAgB;IA0BxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,CAAC,qBAAqB;IAsBvB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkCjD,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAclC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmBvD,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKxC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAczC"}

package/dist/database.js

@@ -0,0 +1,125 @@
+import mysql from "mysql2/promise";
+import { MySQLConfigSchema, MySQLMCPError, } from "./types.js";
+export class MySQLConnection {
+    config;
+    constructor(config) {
+        this.config = MySQLConfigSchema.parse(config);
+    }
+    async createConnection() {
+        try {
+            const connectionOptions = {
+                host: this.config.host,
+                port: this.config.port,
+                user: this.config.user,
+                password: this.config.password,
+                database: this.config.database,
+                connectTimeout: this.config.connectionTimeout,
+            };
+            if (this.config.ssl) {
+                connectionOptions.ssl = {};
+            }
+            return await mysql.createConnection(connectionOptions);
+        }
+        catch (error) {
+            throw new MySQLMCPError(`Failed to connect to MySQL: ${error instanceof Error ? error.message : "Unknown error"}`, "CONNECTION_ERROR");
+        }
+    }
+    async connect() {
+        const connection = await this.createConnection();
+        await connection.end();
+    }
+    async disconnect() {
+        // No-op: connections are managed per-query
+    }
+    validateReadOnlyQuery(query) {
+        const trimmedQuery = query.trim().toLowerCase();
+        const readOnlyPatterns = [
+            /^select\s/,
+            /^show\s/,
+            /^describe\s/,
+            /^desc\s/,
+            /^explain\s/,
+        ];
+        const isReadOnly = readOnlyPatterns.some((pattern) => pattern.test(trimmedQuery));
+        if (!isReadOnly) {
+            throw new MySQLMCPError("Only read-only queries are allowed (SELECT, SHOW, DESCRIBE, EXPLAIN)", "WRITE_OPERATION_NOT_ALLOWED");
+        }
+    }
+    async executeQuery(query) {
+        this.validateReadOnlyQuery(query);
+        const startTime = Date.now();
+        let connection = null;
+        try {
+            connection = await this.createConnection();
+            const [rows] = await connection.execute(query);
+            const executionTime = Date.now() - startTime;
+            const data = Array.isArray(rows)
+                ? rows
+                : [];
+            return {
+                data,
+                rowCount: data.length,
+                executionTime,
+            };
+        }
+        catch (error) {
+            const mysqlError = error;
+            throw new MySQLMCPError(`Query execution failed: ${mysqlError.message}`, mysqlError.code, mysqlError.sqlState);
+        }
+        finally {
+            if (connection) {
+                await connection.end();
+            }
+        }
+    }
+    async listTables() {
+        const result = await this.executeQuery(`
+      SELECT 
+        TABLE_NAME,
+        TABLE_TYPE,
+        TABLE_SCHEMA
+      FROM information_schema.TABLES 
+      WHERE TABLE_SCHEMA = '${this.config.database}'
+      ORDER BY TABLE_NAME
+    `);
+        return result.data;
+    }
+    async describeTable(tableName) {
+        const result = await this.executeQuery(`
+      SELECT 
+        COLUMN_NAME,
+        DATA_TYPE,
+        IS_NULLABLE,
+        COLUMN_DEFAULT,
+        COLUMN_KEY,
+        EXTRA,
+        COLUMN_COMMENT
+      FROM information_schema.COLUMNS 
+      WHERE TABLE_SCHEMA = '${this.config.database}' 
+        AND TABLE_NAME = '${tableName}'
+      ORDER BY ORDINAL_POSITION
+    `);
+        return result.data;
+    }
+    async showDatabases() {
+        const result = await this.executeQuery("SHOW DATABASES");
+        return result.data;
+    }
+    async testConnection() {
+        let connection = null;
+        try {
+            connection = await this.createConnection();
+            await connection.execute("SELECT 1 as test");
+            return true;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            if (connection) {
+                await connection.end();
+            }
+        }
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+export { MySQLMCPServer } from "./server.js";
+export { MySQLConnection } from "./database.js";
+export { MySQLMCPTools } from "./tools.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAsBA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { MySQLMCPServer } from "./server.js";
+async function main() {
+    try {
+        const server = MySQLMCPServer.fromEnvironment();
+        server.setupGracefulShutdown();
+        await server.start();
+    }
+    catch (error) {
+        console.error("Failed to start MySQL MCP Server:", error);
+        process.exit(1);
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((error) => {
+        console.error("Fatal error:", error);
+        process.exit(1);
+    });
+}
+export { MySQLMCPServer } from "./server.js";
+export { MySQLConnection } from "./database.js";
+export { MySQLMCPTools } from "./tools.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,EAAE,CAAC;QAChD,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,cAAc,YAAY,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { MySQLConfig } from "./types.js";
+export declare class MySQLMCPServer {
+    private server;
+    private db;
+    private tools;
+    constructor(config: MySQLConfig);
+    static fromEnvironment(): MySQLMCPServer;
+    private setupTools;
+    start(): Promise<void>;
+    cleanup(): Promise<void>;
+    setupGracefulShutdown(): void;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,WAAW,EAOZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,EAAE,CAAkB;IAC5B,OAAO,CAAC,KAAK,CAAgB;gBAEjB,MAAM,EAAE,WAAW;IAY/B,MAAM,CAAC,eAAe,IAAI,cAAc;IAiBxC,OAAO,CAAC,UAAU;IAmDZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B,qBAAqB,IAAI,IAAI;CAoB9B"}

package/dist/server.js

@@ -0,0 +1,106 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { MySQLConnection } from "./database.js";
+import { MySQLMCPTools } from "./tools.js";
+import { MySQLConfigSchema, ReadQueryParamsSchema, DescribeTableParamsSchema, MySQLMCPError, } from "./types.js";
+export class MySQLMCPServer {
+    server;
+    db;
+    tools;
+    constructor(config) {
+        this.server = new McpServer({
+            name: "mysql-mcp-server",
+            version: "1.0.0",
+        });
+        this.db = new MySQLConnection(config);
+        this.tools = new MySQLMCPTools(this.db);
+        this.setupTools();
+    }
+    static fromEnvironment() {
+        const config = MySQLConfigSchema.parse({
+            host: process.env.MYSQL_HOST || "localhost",
+            port: parseInt(process.env.MYSQL_PORT || "3306", 10),
+            user: process.env.MYSQL_USER || "root",
+            password: process.env.MYSQL_PASSWORD || "",
+            database: process.env.MYSQL_DATABASE || "test",
+            ssl: process.env.MYSQL_SSL === "true",
+            connectionTimeout: parseInt(process.env.MYSQL_CONNECTION_TIMEOUT || "30000", 10),
+        });
+        return new MySQLMCPServer(config);
+    }
+    setupTools() {
+        this.server.registerTool("read_query", {
+            title: "Execute Read Query",
+            description: "Execute a SELECT query on the MySQL database",
+            inputSchema: { query: ReadQueryParamsSchema.shape.query },
+        }, async (params) => {
+            return this.tools.readQuery(params);
+        });
+        this.server.registerTool("list_tables", {
+            title: "List Tables",
+            description: "List all tables in the current database",
+            inputSchema: {},
+        }, async () => {
+            return this.tools.listTables();
+        });
+        this.server.registerTool("describe_table", {
+            title: "Describe Table",
+            description: "Get the structure and schema information of a specific table",
+            inputSchema: { tableName: DescribeTableParamsSchema.shape.tableName },
+        }, async (params) => {
+            return this.tools.describeTable(params);
+        });
+        this.server.registerTool("show_databases", {
+            title: "Show Databases",
+            description: "List all available databases on the MySQL server",
+            inputSchema: {},
+        }, async () => {
+            return this.tools.showDatabases();
+        });
+    }
+    async start() {
+        try {
+            await this.db.connect();
+            const isConnected = await this.db.testConnection();
+            if (!isConnected) {
+                throw new MySQLMCPError("Database connection test failed", "CONNECTION_TEST_FAILED");
+            }
+            const transport = new StdioServerTransport();
+            await this.server.connect(transport);
+            console.error("MySQL MCP Server started successfully");
+        }
+        catch (error) {
+            console.error("Failed to start MySQL MCP Server:", error instanceof Error ? error.message : error);
+            await this.cleanup();
+            process.exit(1);
+        }
+    }
+    async cleanup() {
+        try {
+            await this.db.disconnect();
+        }
+        catch (error) {
+            console.error("Error during cleanup:", error instanceof Error ? error.message : error);
+        }
+    }
+    setupGracefulShutdown() {
+        const shutdown = async (signal) => {
+            console.error(`Received ${signal}, shutting down gracefully...`);
+            await this.cleanup();
+            process.exit(0);
+        };
+        process.on("SIGINT", () => shutdown("SIGINT"));
+        process.on("SIGTERM", () => shutdown("SIGTERM"));
+        process.on("uncaughtException", async (error) => {
+            console.error("Uncaught exception:", error);
+            await this.cleanup();
+            process.exit(1);
+        });
+        process.on("unhandledRejection", async (reason) => {
+            console.error("Unhandled rejection:", reason);
+            await this.cleanup();
+            process.exit(1);
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,11 @@
+import { MySQLConnection } from "./database.js";
+import { ReadQueryParams, DescribeTableParams, McpToolResult } from "./types.js";
+export declare class MySQLMCPTools {
+    private db;
+    constructor(db: MySQLConnection);
+    readQuery(params: ReadQueryParams): Promise<McpToolResult>;
+    listTables(): Promise<McpToolResult>;
+    describeTable(params: DescribeTableParams): Promise<McpToolResult>;
+    showDatabases(): Promise<McpToolResult>;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAa;IACZ,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,eAAe;IAEjC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAiD1D,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC;IAkDpC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwDlE,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;CA6C9C"}

package/dist/tools.js

@@ -0,0 +1,153 @@
+import { MySQLMCPError, } from "./types.js";
+export class MySQLMCPTools {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async readQuery(params) {
+        try {
+            const result = await this.db.executeQuery(params.query);
+            const resultText = JSON.stringify({
+                query: params.query,
+                rowCount: result.rowCount,
+                executionTime: `${result.executionTime}ms`,
+                data: result.data,
+            }, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: resultText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof MySQLMCPError
+                ? `MySQL Error: ${error.message}`
+                : `Unexpected error: ${error instanceof Error ? error.message : "Unknown error"}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: errorMessage,
+                            query: params.query,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    }
+    async listTables() {
+        try {
+            const tables = await this.db.listTables();
+            const resultText = JSON.stringify({
+                tableCount: tables.length,
+                tables: tables.map((table) => ({
+                    name: table.TABLE_NAME,
+                    type: table.TABLE_TYPE,
+                    schema: table.TABLE_SCHEMA,
+                })),
+            }, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: resultText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof MySQLMCPError
+                ? `MySQL Error: ${error.message}`
+                : `Unexpected error: ${error instanceof Error ? error.message : "Unknown error"}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: errorMessage,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    }
+    async describeTable(params) {
+        try {
+            const columns = await this.db.describeTable(params.tableName);
+            const resultText = JSON.stringify({
+                tableName: params.tableName,
+                columnCount: columns.length,
+                columns: columns.map((column) => ({
+                    name: column.COLUMN_NAME,
+                    type: column.DATA_TYPE,
+                    nullable: column.IS_NULLABLE === "YES",
+                    default: column.COLUMN_DEFAULT,
+                    key: column.COLUMN_KEY,
+                    extra: column.EXTRA,
+                    comment: column.COLUMN_COMMENT,
+                })),
+            }, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: resultText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof MySQLMCPError
+                ? `MySQL Error: ${error.message}`
+                : `Unexpected error: ${error instanceof Error ? error.message : "Unknown error"}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: errorMessage,
+                            tableName: params.tableName,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    }
+    async showDatabases() {
+        try {
+            const databases = await this.db.showDatabases();
+            const resultText = JSON.stringify({
+                databaseCount: databases.length,
+                databases: databases.map((db) => db.Database),
+            }, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: resultText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof MySQLMCPError
+                ? `MySQL Error: ${error.message}`
+                : `Unexpected error: ${error instanceof Error ? error.message : "Unknown error"}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: errorMessage,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    }
+}
+//# sourceMappingURL=tools.js.map