MCP Server Mysql

🚀 mcp-server-mysql

A MySQL database server for the Model Context Protocol. This server enables large language models to inspect the database schema and execute read-only queries.

🚀 Quick Start

The mcp-server-mysql is a MySQL database server for the Model Context Protocol, which allows large language models to inspect database schemas and perform read-only queries.

✨ Features

• Read-only access to MySQL databases.
• Database schema inspection functionality.
• Securely execute queries within READ ONLY transactions.
• Docker support.
• Available as an NPM package.

📦 Installation

Using Docker

# Build the Docker image
make docker

# Run with Docker
docker run -i --rm mcp/mysql mysql://host:port/dbname

Installation via Smithery

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

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

💻 Usage Examples

Usage with Claude Desktop

Add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "mysql": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/mysql",
        "mysql://host:port/dbname"
      ]
    }
  }
}

⚠️ Important Note

When using Docker on macOS, if the MySQL server is running on the host network, replace /database with host.docker.internal.

Connection URL Format

mysql://[user][:password]@host[:port]/database

Replace /database with the name of your database.

🔧 Technical Details

# Initial setup
make setup

# Build the project
make build

# Format the code
make format

# Run check tools
make lint

📄 License

This project is released under the MIT License.

🔒 Security

This server enforces read-only access to protect your database. All queries are executed within READ ONLY transactions.

💡 Usage Tip

For enhanced security, we recommend creating a read-only user.