MCP.so
Sign In

MCP MySQL Server

@cnosuke

Repository

About MCP MySQL Server

MCP server that acts as a MySQL Client implemented in Go language

Basic information

Category

Databases

Runtime

go

Transports

stdio

Publisher

cnosuke

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-mysql-cnosuke": {
      "command": "docker",
      "args": [
        "pull",
        "cnosuke/mcp-mysql:latest"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP MySQL Server?

MCP MySQL Server is a Go-based MCP (Model Context Protocol) server implementation that provides MySQL database interaction functionality, allowing MCP clients such as Claude Desktop to perform database operations.

How to use MCP MySQL Server?

Run the server via Docker (docker pull cnosuke/mcp-mysql:latest and appropriate environment variables) or build and run the Go binary (./bin/mcp-mysql server --config=config.yml). Integrate with Claude Desktop by adding an entry to claude_desktop_config.json using either the Docker command or the Go binary path, and configure MySQL connection settings via environment variables or a YAML config file.

Key features of MCP MySQL Server

  • JSON‑RPC based MCP-compliant interface.
  • Supports querying, schema inspection, and data manipulation.
  • Optional read‑only mode to prevent data modification.
  • Optional EXPLAIN query plan verification.
  • Accepts URL-style connection strings (mysql://user:pass@host:port/dbname).
  • Minimal Docker image built with Google's distroless base.

Use cases of MCP MySQL Server

  • Query a MySQL database through an AI assistant like Claude Desktop.
  • Inspect database schemas and list tables without writing custom code.
  • Safely explore production data using read‑only mode.
  • Perform controlled data updates or inserts via an MCP client.

FAQ from MCP MySQL Server

How do I enable read‑only mode?

Set the environment variable MYSQL_READ_ONLY=true or set mysql.read_only: true in the configuration file. In read‑only mode, only tools starting with list_, read_, and desc_ are available.

What connection methods are supported?

You can provide connection details via tool parameter (dsn), DSN in config (mysql.dsn), or individual config parameters (host, user, password, port, database). The server uses URL-style or native MySQL DSN formats.

What runtime does the server require?

For Docker deployment no additional runtime is needed. For local development, Go 1.24 or later and a MySQL server are required.

Can I use environment variables for configuration?

Yes. Environment variables such as MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE, MYSQL_DSN, MYSQL_READ_ONLY, and MYSQL_EXPLAIN_CHECK override corresponding YAML settings.

Is the server available for MariaDB connections?

The server supports URL schemes mysql:// and mariadb://. The MySQL DSN format used is compatible with both MySQL and MariaDB servers.

Comments

More Databases MCP servers

Meilisearch MCP Server

meilisearch

A Model Context Protocol (MCP) server for interacting with Meilisearch through LLM interfaces.

193

Postgres Mcp

crystaldba

Postgres MCP Pro provides configurable read/write access and performance analysis for you and your AI agents.

3.0K

MCP MongoDB Server

kiliczsh

A Model Context Protocol Server for MongoDB

281

MCP Server for Milvus

zilliztech

Model Context Protocol Servers for Milvus

235

MCP Server for MySQL based on NodeJS

benborla

A Model Context Protocol server that provides read-only access to MySQL databases. This server enables LLMs to inspect database schemas and execute read-only queries.

1.9K