MySQL Legacy MCP

MySQL Legacy MCP

stdio 経由でレガシーな MySQL 5.0～5.6 データベースに接続する MCP サーバーです。パッケージは npm では mysql-legacy-mcp として、公式 MCP Registry では io.github.Rufflet/mysql-legacy-mcp として公開されています。

MySQL 5.1 互換の SQL と SHOW メタデータクエリを使用します。ライブ MCP テストでは、MySQL 5.0.51a、5.1.73、5.5.62、5.6.51 を対象としています。意図的に機能を絞っており、デフォルトでは読み取り専用です。INSERT／UPDATE／DELETE／DDL は、明示的に有効化しない限り無効のオプトインツールとして提供されます。TLS 設定、カスタム認証、文字セットオプションはありません。

これはあなたに適していますか？

• AI エージェントを使って MySQL 5.0、5.1、5.5、または 5.6 のデータベースを調査する必要がある場合。
• 現在使用している MySQL MCP サーバーが MySQL 5.7 以降、JSON 関数、または新しい information_schema フィールドを前提としている場合。
• 書き込み操作はデフォルトで無効にし、文の種類ごとにオプトインで有効化しながら、スキーマの調査と SELECT クエリを実行する必要がある場合。

ER_NOT_SUPPORTED_AUTH_MODE、HANDSHAKE_INSECURE_AUTH、Old password authentication is not supported、レガシー TLS エラー、または文字化けした cp1251／latin1 のテキストが発生している場合は、まずトラブルシューティングをお読みください。これらの症状がすべてこのパッケージで解決されるわけではありません。

要件

• Node.js 18.14.1 以降
• npm
• 必要な読み取り権限とメタデータ権限のみを持つ専用の MySQL アカウント

掲載先

インストールは常に npm を使ったローカル stdio 接続です（npx -y mysql-legacy-mcp）。ディレクトリのページを見ても、インストールが速くなるわけではありません。これらはサービスを見つけるためのインデックスです。公式 MCP Registry は、アグリゲーターが取り込む機械可読な情報源（io.github.Rufflet/mysql-legacy-mcp）です。server.json の環境変数メタデータも含まれています。このレジストリに対応するクライアントでは、レジストリの情報を使って設定を事前入力できます。

• npm
• 公式 MCP Registry
• Glama
• TensorBlock MCP Index
• Awesome MCP Servers
• Awesome MCP ZH

その他のディレクトリへのメンテナーによる申請状況は、docs/RELEASE_CHECKLIST.md に記載されています。

クイックインストール

Claude Code

claude mcp add --transport stdio mysql-legacy \
  --env MYSQL_LEGACY_HOST=127.0.0.1 \
  --env MYSQL_LEGACY_USER=legacy_reader \
  --env MYSQL_LEGACY_PASSWORD=replace-with-a-secret \
  --env MYSQL_LEGACY_DATABASE=legacy_app \
  -- npx -y mysql-legacy-mcp

Codex

codex mcp add mysql-legacy \
  --env MYSQL_LEGACY_HOST=127.0.0.1 \
  --env MYSQL_LEGACY_USER=legacy_reader \
  --env MYSQL_LEGACY_PASSWORD=replace-with-a-secret \
  --env MYSQL_LEGACY_DATABASE=legacy_app \
  -- npx -y mysql-legacy-mcp

Cursor およびその他のクライアント

{
  "mcpServers": {
    "mysql-legacy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mysql-legacy-mcp"],
      "env": {
        "MYSQL_LEGACY_HOST": "127.0.0.1",
        "MYSQL_LEGACY_USER": "legacy_reader",
        "MYSQL_LEGACY_PASSWORD": "replace-with-a-secret",
        "MYSQL_LEGACY_DATABASE": "legacy_app"
      }
    }
  }
}

クライアントで必要なスキーマを使用してください。Claude Desktop、Codex、VS Code、Windsurf、Gemini、Trae、Qoder などの、コピーしてそのまま使える手順については、インストールガイドをご覧ください。

互換性

MySQL	状態
5.0	検証済み：5.0.51a
5.1	検証済み：5.1.73
5.5	検証済み：5.5.62
5.6	検証済み：5.6.51
5.7	参照のみ確認済み：5.7.44
8.0	対象外。デフォルトの caching_sha2_password はサポートされていません

テスト対象の各バージョンで、実際の MCP stdio セッションを通じて、11 個すべてのツール（読み取り専用ツール 7 個と、オプトインの書き込みツール 4 個）に合格しました。MYSQL_LEGACY_ALLOW_* フラグは、デフォルトの false のままの場合と、明示的に有効にした場合の両方で確認しています。MySQL 5.6.5 以降では、mysql_legacy_select が使用する実際の START TRANSACTION READ ONLY パスもテストしました。それより前のバージョンでは、警告なしで通常のクエリにフォールバックする動作をテストしています。正確なソース、テスト条件、MySQL 8.0 の境界については、互換性監査に記録されています。これには、4.1 より前の old_password、カスタム接続文字セット、TLS、お使いのサーバーの正確なパッチレベルは含まれません。

最新の MySQL MCP サーバーとの比較

サーバー	明記されている MySQL の最低バージョン	主な用途
mysql-legacy-mcp	実環境で検証済み：5.0～5.6	レガシースキーマの調査とデフォルトの SELECT。オプトインで INSERT/UPDATE/DELETE/DDL を実行でき、UPDATE/DELETE には常に WHERE 句が必要です
@benborla29/mcp-server-mysql	5.7 以降。8.0 以降を推奨	TLS、SSH トンネル、オプションの書き込みなど、最新の MySQL 機能

これはベンチマークではなく、互換性の違いです。最新のデータベース機能を利用する場合は、最新のサーバーを選択してください。

機能

• パーサーチェックと結果サイズ制限を備え、MySQL 5.6.5 以降では読み取り専用トランザクション内で実行される、読み取り専用の SELECT ツール
• SHOW を使ったデータベース、テーブル、カラム、CREATE TABLE、インデックスの調査
• デフォルトで無効になっており、それぞれ独自の MYSQL_LEGACY_ALLOW_* フラグで制御される、オプトインの INSERT/UPDATE/DELETE/DDL ツール。UPDATE と DELETE には常に WHERE 句が必要です
• MySQL 接続の小規模なプール（MYSQL_LEGACY_POOL_SIZE）。CTE、JSON 関数、最新のメタデータカラムには依存しません

ツール

ツール	用途
mysql_legacy_ping	VERSION() を返す
mysql_legacy_select	パース済みの SELECT 文を 1 つ実行する
mysql_legacy_insert	INSERT 文を 1 つ実行する（オプトイン、MYSQL_LEGACY_ALLOW_INSERT）
mysql_legacy_update	WHERE 句が必須の UPDATE 文を 1 つ実行する（オプトイン、MYSQL_LEGACY_ALLOW_UPDATE）
mysql_legacy_delete	WHERE 句が必須の DELETE 文を 1 つ実行する（オプトイン、MYSQL_LEGACY_ALLOW_DELETE）
mysql_legacy_ddl	テーブルレベルの CREATE/ALTER/DROP/TRUNCATE/RENAME 文を 1 つ実行する（オプトイン、MYSQL_LEGACY_ALLOW_DDL）
mysql_legacy_list_databases	データベースを一覧表示する
mysql_legacy_list_tables	テーブルとビューを一覧表示する
mysql_legacy_describe_table	カラムを表示する
mysql_legacy_show_create_table	テーブルの DDL を表示する
mysql_legacy_list_indexes	インデックスを表示する

ドキュメント

• インストールガイド — クライアント固有のセットアップ
• 設定 — 環境変数、権限、セキュリティ上の制限
• トラブルシューティング — 認証、TLS、エンコーディング、起動時のエラー
• 互換性監査 — 再現可能なバージョンの検証結果
• ロードマップ — 意図的に延期した作業とその理由

このプロジェクトの目的

このプロジェクトは、AI による支援を受けながら本番環境の MySQL 5.1 データベースを調査する必要があった、QA／フルスタックのワークフローから生まれました。レガシースキーマの調査と移行の準備に特化したユーティリティです。

コントリビューション

変更の提案方法、ローカルでのチェックの実行方法、互換性に関する主張に必要な根拠については、CONTRIBUTING.md をご覧ください。クイックスタート：

npm ci
npm run check
npm run smoke:static

許可されたデータベースのテストについては、互換性監査のスモークテスト手順をご覧ください。

ライセンス

MIT。