mcp-server-mysql

View original on GitHub

Model Context Protocol Server for MySQL databases. This server enables LLMs to inspect database schemas and execute read-only queries.

Features

Read-only access to MySQL databases
Schema inspection capabilities
Safe query execution within READ ONLY transactions
Docker support
NPM package available

Installation

Using Docker


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

Using NPM


npm install @modelcontextprotocol/server-mysql

Installing via Smithery

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


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

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"
      ]
    }
  }
}

Note: When using Docker on macOS, use host.docker.internal if the MySQL server is running on the host network.

Connection URL Format


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

Replace /database with your database name.

Development


# Initial setup
make setup
 
# Build the project
make build
 
# Format code
make format
 
# Run linter
make lint

License

MIT License - see LICENSE file for details.

Security

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

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

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.