MCP MySQL Server

@cnosuke

リポジトリ

基本情報

カテゴリ

データベース

トランスポート

stdio

作者

cnosuke

MCP MySQL Server について

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

MCP MySQL Server の設定

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

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

MCP MySQL Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

ツールは 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.

よくある質問

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.

「データベース」の他のコンテンツ

Schemity

tbson

Local database MCP server: your agent sees a migration's impact before it runs, for PostgreSQL, MySQL, SQL Server and SQLite, with no database credentials.