MySQL MCP

MySQL MCP は、AI アプリケーションを 1 つの MySQL または MariaDB データベースに接続します。構造を確認したり、自然言語でデータに質問したり、遅いクエリを調査したり、そして自分で許可した場合にはデータを変更したりできます。

サーバーは 1 つのデータベースにバインドされています。データベースは構成で指定され、どのツールも別のデータベースにアクセスできません。デフォルトでは読み取り専用です。

• 6 つのツール。 接続と権限、テーブル一覧、テーブル構造、読み取りクエリ、クエリプラン、変更クエリ。

• クエリの種類はサーバーが決定します。 SQL は接続前に解析されます。書き込み権限が有効でも、読み取りツールでの DELETE は拒否されます。

• 読み取りは書き込みできません。 読み取りクエリは START TRANSACTION READ ONLY 内で実行されます。SQL 解析を回避しようとしても、MySQL 自体が書き込みを拒否します。

• 応答がコンテキストをあふれさせません。 行はストリームで読み取られ、すべてをダウンロードするのではなく制限で打ち切られます。応答には正直な truncated フラグが含まれます。

• 権限は外部からのみ。 INSERT、UPDATE、DELETE は環境変数で有効になり、再起動が必要です。ダイアログから取得することはできません。DDL は常に使用できません。

データを読み取るだけのクエリから始めましょう。

データベースの構造を表示して、先週追加されたレコードの数を数えてください。

クイックスタート

Claude Code:

claude mcp add mysql-myapp \
  -e MYSQL_HOST=db.example.com \
  -e MYSQL_USER=myapp_ro \
  -e MYSQL_PASS='пароль' \
  -e MYSQL_DB=myapp \
  -e MYSQL_SSL=true \
  -- npx -y mcp-mysql-client

または .mcp.json / claude_desktop_config.json 内:

{
  "mcpServers": {
    "mysql-myapp": {
      "command": "npx",
      "args": ["-y", "mcp-mysql-client"],
      "env": {
        "MYSQL_HOST": "db.example.com",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "myapp_ro",
        "MYSQL_PASS": "пароль",
        "MYSQL_DB": "myapp",
        "MYSQL_SSL": "true"
      }
    }
  }
}

1 つのサーバーは 1 つのデータベースに接続します。複数のデータベースが必要な場合は、それぞれの資格情報を追加してください。これにより権限が分離され、テストデータベースに接続されたサーバーは本番データベースを物理的に認識できません。

Related MCP server: MySQL MCP Server

実行できること

変更できること

デフォルトでは何も変更できません。サーバーは読み取り専用モードで起動します。書き込みは操作ごとに有効にします。

"ALLOW_INSERT_OPERATION": "true",
"ALLOW_UPDATE_OPERATION": "true",
"ALLOW_DELETE_OPERATION": "false"

それでも不可能なこと:

• DDL — CREATE、ALTER、DROP、TRUNCATE、RENAME — いかなる設定でも不可。

• データベースの変更、SET、CALL、PREPARE、LOAD DATA、ロック、GRANT など、次のクエリの意味を変えたり、未検証のテキストを実行したりするもの。

• SELECT ... INTO OUTFILE — データベースサーバーへのファイル書き込み。

• WHERE 句のない UPDATE および DELETE — 呼び出しで allow_full_table=true の明示的な確認が必要。

• 1 回の呼び出しでの複数ステートメント — 実行されるのは正確に 1 つのみ。

MySQL の権限は、これに加えて別の制限です。ALLOW_UPDATE_OPERATION を許可しても、GRANT UPDATE を持たないユーザーには何も追加されません。実践的な方法は、root ではなく、最小限の権限を持つ専用ユーザーを使用することです。

環境変数

MCP クライアントの構成では、パスワードは平文で保存されます。MYSQL_PASS_FILE を使用すると、適切な権限を持つファイルにパスワードを保持できます。

@benborla29/mcp-server-mysql からの移行

変数名は同じなので、起動コマンドのパッケージを置き換えるだけです。

-  "args": ["-y", "@benborla29/mcp-server-mysql"]
+  "args": ["-y", "mcp-mysql-client"]

動作の変更点:

• MYSQL_DB は必須です。サーバーは常に 1 つのデータベースにバインドされます。

• 応答は MYSQL_MAX_ROWS に制限され、truncated とマークされます。

• 書き込み権限が有効でも DDL は使用できません。

• WHERE 句のない UPDATE/DELETE は呼び出しでの確認が必要です。

• ツールセットが異なります: query、execute、explain、list_tables、describe_table、server_info。

診断

まず server_info を確認します。サーバーが何に接続されているか、MySQL ユーザーが持つ権限、有効な制限が表示されます。

技術ドキュメント

• ツール — パラメータと応答

• 開発 — ビルド、テスト、ライブチェック

• 公開 — npm と MCP レジストリへのリリース

• CLAUDE.md — AI エージェント向けリポジトリ構成

ライセンス

MIT