MCP Server for MySQL based on NodeJS

MySQL 用 MCP サーバー

スポンサー — Bloome

mcp-server-mysql を使って AI に MySQL のクエリを実行させていますか？Bloome を使えば、チーム全体で利用できます。AI エージェントがチャットメンバーとなる、AI エージェント向けの IM プラットフォームです。MCP ツールを接続すれば、エージェントがスキーマを確認し、クエリを実行し、データに関する質問にスレッド内で全員に回答できます。ローカルでのセットアップは不要で、クラウド上で動作し、ウェブとモバイルから利用できます。

---

Claude やその他の LLM が MySQL にアクセスできるようにする MCP サーバーです。Model Context Protocol を通じて、スキーマの確認、クエリの実行、必要に応じたデータの書き込みができます。

主な機能

• デフォルトで読み取り専用 — 書き込み操作は環境変数フラグで明示的に有効化
• Claude Code との連携 — Anthropic の Claude Code CLI に最適化
• SSH トンネルのサポート — リモートデータベースに標準対応
• マルチ DB モード — 再接続せずに複数のデータベースにまたがってクエリを実行
• スキーマごとの権限 — データベース単位で読み取り／書き込みを制御
• PII のマスキング — 結果内の機密データを自動的にマスキング
• リモートモード — ベアラートークン認証による HTTP トランスポート
• SSL/TLS のサポート — mTLS オプション付きの暗号化接続

要件

• Node.js v20+
• MySQL 5.7+（8.0+ を推奨）
• 適切な権限を持つ MySQL ユーザー

クイックインストール

Claude Code（最も簡単）：

claude mcp add mcp_server_mysql \
  -e MYSQL_HOST="127.0.0.1" \
  -e MYSQL_PORT="3306" \
  -e MYSQL_USER="root" \
  -e MYSQL_PASS="your_password" \
  -e MYSQL_DB="your_database" \
  -- npx @benborla29/mcp-server-mysql

Claude Desktop／その他のクライアント：

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

すべての書き込み操作はデフォルトで無効です。ALLOW_INSERT_OPERATION=true、ALLOW_UPDATE_OPERATION=true、ALLOW_DELETE_OPERATION=true を指定すると有効になります。

ドキュメント

• インストールガイド — Smithery、Cursor、Codex、Claude Code、ローカルリポジトリ、リモートモード
• 設定と環境変数 — すべての環境変数、高度な設定
• マルチ DB モード — 複数のデータベースに対するクエリ実行
• PII のマスキング — データの自動マスキング
• テスト — テストのセットアップと実行
• トラブルシューティング — よくある問題と解決方法
• 変更履歴

ツールとリソース

ツール：mysql_query SQL クエリを実行します。デフォルトでは読み取り専用です。フラグごとに書き込み操作を有効にできます。

リソース：mysql://tables 接続中のデータベースにあるすべてのテーブルと列のメタデータを一覧表示します。

コントリビューション

github.com/benborla/mcp-server-mysql への PR を歓迎します。

git clone https://github.com/benborla/mcp-server-mysql.git
pnpm install
pnpm run build
pnpm test

ライセンス

MIT — 詳細は LICENSE をご覧ください。