MCP MySQL Server

Name: MCP MySQL Server
Author: cnosuke

@cnosuke

リポジトリ

MCP MySQL Server について

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

基本情報

カテゴリ

データベース

ランタイム

トランスポート

stdio

公開者

cnosuke

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.