Mysql Database Server 6m3

🚀 @f4ww4z/mcp-mysql-server

A Model Context Protocol (MCP) server that provides MySQL database operations. This server allows AI models to interact with MySQL databases through a standardized interface.

🚀 Quick Start

📦 Installation

Install via Smithery

To automatically install the MySQL server for Claude Desktop via Smithery:

npx -y @smithery/cli install @f4ww4z/mcp-mysql-server --client claude

Manual Installation

npx @f4ww4z/mcp-mysql-server

⚙️ Configuration

This server requires the following environment variables to be set in your MCP configuration file:

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@f4ww4z/mcp-mysql-server"],
      "env": {
        "MYSQL_HOST": "your_host",
        "MYSQL_USER": "your_user",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

1. connect_db

Establish a MySQL database connection using the provided credentials.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

2. query

Execute a SELECT query with optional prepared statement parameters.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "query",
  arguments: {
    sql: "SELECT * FROM users WHERE id = ?",
    params: [1]
  }
});

3. execute

Execute an INSERT, UPDATE, or DELETE query with optional prepared statement parameters.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "execute",
  arguments: {
    sql: "INSERT INTO users (name, email) VALUES (?, ?)",
    params: ["John Doe", "john@example.com"]
  }
});

4. list_tables

List all tables in the database.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "list_tables",
  arguments: {}
});

5. describe_table

Get the structure of a specific table.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "describe_table",
  arguments: {
    table: "users"
  }
});

✨ Features

• Secure connection handling with automatic cleanup.
• Prepared statement support to prevent SQL injection.
• Comprehensive error handling and validation.
• TypeScript support.
• Automated connection management.

🔒 Security

• Use prepared statements to prevent SQL injection.
• Support secure password handling through environment variables.
• Validate queries before execution.
• Automatically close connections after use.

🚫 Error Handling

This server provides detailed error messages for common issues:

• Connection failure
• Invalid query
• Missing parameters
• Database errors

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request to https://github.com/f4ww4z/mcp-mysql-server

📄 License

MIT