MySQL

MySQL MCP Server

A Model Context Protocol (MCP) implementation that enables secure interaction with MySQL databases. This server component facilitates communication between AI applications (hosts/clients) and MySQL databases, making database exploration and analysis safer and more structured through a controlled interface.

Note: MySQL MCP Server is not designed to be used as a standalone server, but rather as a communication protocol implementation between AI applications and MySQL databases.

Features

List available MySQL tables as resources
Read table contents
Execute SQL queries with proper error handling
Secure database access through environment variables
Comprehensive logging

Installation

Manual Installation

1pip install mysql-mcp-server

Installing via Smithery

To install MySQL MCP Server for Claude Desktop automatically via Smithery:

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

Configuration

Set the following environment variables:

1MYSQL_HOST=localhost     # Database host
2MYSQL_PORT=3306         # Optional: Database port (defaults to 3306 if not specified)
3MYSQL_USER=your_username
4MYSQL_PASSWORD=your_password
5MYSQL_DATABASE=your_database

Usage

With Claude Desktop

Add this to your claude_desktop_config.json:

1{
2  "mcpServers": {
3    "mysql": {
4      "command": "uv",
5      "args": [
6        "--directory", 
7        "path/to/mysql_mcp_server",
8        "run",
9        "mysql_mcp_server"
10      ],
11      "env": {
12        "MYSQL_HOST": "localhost",
13        "MYSQL_PORT": "3306",
14        "MYSQL_USER": "your_username",
15        "MYSQL_PASSWORD": "your_password",
16        "MYSQL_DATABASE": "your_database"
17      }
18    }
19  }
20}

Debugging with MCP Inspector

While MySQL MCP Server isn't intended to be run standalone or directly from the command line with Python, you can use the MCP Inspector to debug it.

The MCP Inspector provides a convenient way to test and debug your MCP implementation:

1# Install dependencies
2pip install -r requirements.txt
3# Use the MCP Inspector for debugging (do not run directly with Python)

The MySQL MCP Server is designed to be integrated with AI applications like Claude Desktop and should not be run directly as a standalone Python program.

Development

1# Clone the repository
2git clone https://github.com/yourusername/mysql_mcp_server.git
3cd mysql_mcp_server
4# Create virtual environment
5python -m venv venv
6source venv/bin/activate  # or `venv\Scripts\activate` on Windows
7# Install development dependencies
8pip install -r requirements-dev.txt
9# Run tests
10pytest

Security Considerations

Never commit environment variables or credentials
Use a database user with minimal required permissions
Consider implementing query whitelisting for production use
Monitor and log all database operations

Security Best Practices

This MCP implementation requires database access to function. For security:

Create a dedicated MySQL user with minimal permissions
Never use root credentials or administrative accounts
Restrict database access to only necessary operations
Enable logging for audit purposes
Regular security reviews of database access

See MySQL Security Configuration Guide for detailed instructions on:

Creating a restricted MySQL user
Setting appropriate permissions
Monitoring database access
Security best practices

⚠️ IMPORTANT: Always follow the principle of least privilege when configuring database access.

License

MIT License - see LICENSE file for details.

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Contents