MySQL MCPサーバー

「MySQL」MCPサーバーは何をするのか？

MySQL MCPサーバーは、AIアシスタントとMySQLデータベースの安全な連携を可能にするModel Context Protocol（MCP）実装です。橋渡し役として、AIアプリケーションがMySQLデータベースを安全に探索・分析・操作できるよう、制御されたインターフェースを提供します。このサーバーは単体での使用を想定せず、バックエンドコンポーネントとしてAI開発ワークフローに組み込むために設計されています。利用可能なMySQLテーブルの一覧取得、テーブル内容の取得、SQLクエリの実行、環境変数によるセキュアなアクセス制御などの機能により、開発者はAIシステムをライブデータベースと接続し、クエリ管理やデータベース中心のタスクを効率化できます。包括的なログ記録やエラーハンドリングも備え、堅牢な運用を実現します。

プロンプト一覧

このリポジトリにはプロンプトテンプレートに関する情報はありません。

リソース一覧

• MySQLテーブルをリソースとして公開
  サーバーは利用可能なMySQLテーブルをリソースとして公開し、AIクライアントがデータベース構造を発見できます。
• テーブル内容
  クライアントはMySQLテーブルの内容にアクセス・参照でき、データ駆動型AIワークフローを実現します。
• クエリ結果
  実行したSQLクエリの結果は、クライアントでのさらなる処理のためにコンテキストリソースとして提供されます。

ツール一覧

• テーブル一覧取得
  接続されたデータベース内の全MySQLテーブル名をリストアップします。
• テーブル内容の読み取り
  指定したテーブルの内容を読み取り、データ探索や取得をサポートします。
• SQLクエリの実行
  接続されたMySQLデータベースに対し任意のSQLクエリを実行。エラーハンドリングとセキュリティ制御付きです。

このMCPサーバーのユースケース

• データベース管理
  AIアシスタントがMySQLデータベースを安全に管理・クエリでき、開発者のDB管理業務を効率化します。
• データ分析・探索
  ライブなデータベーステーブルや内容へのアクセスにより、AIによるデータ探索、要約、可視化が可能です。
• 自動レポーティング
  データベース情報を直接クエリ・処理し、分析やレポートの自動生成をAIツール経由で実現します。
• コード生成・デバッグ
  開発者はAIを活用してSQLクエリの生成・最適化や、実際のスキーマ・データを使ったデバッグが行えます。
• LLM向けの安全なデータアクセス
  LLMベースのエージェントがデータベース認証情報を直接持たずにコンテキストやタスク実行でき、セキュリティ向上につながります。

セットアップ方法

Windsurf

1. PythonとMySQLをインストールし、pip install mysql-mcp-serverでmysql-mcp-serverパッケージをインストールします。
2. Windsurfの設定ファイルを見つけます。
3. 設定ファイルに以下のJSONを追加してMySQL MCPサーバーを登録します:

   {
     "mcpServers": {
       "mysql": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/mysql_mcp_server",
           "run",
           "mysql_mcp_server"
         ],
         "env": {
           "MYSQL_HOST": "localhost",
           "MYSQL_PORT": "3306",
           "MYSQL_USER": "your_username",
           "MYSQL_PASSWORD": "your_password",
           "MYSQL_DATABASE": "your_database"
         }
       }
     }
   }
   

4. 設定を保存し、Windsurfを再起動します。
5. MySQL MCPサーバーがアクティブとして表示されていることを確認します。

APIキーの保護:
上記のように "env" オブジェクトで環境変数を活用し、機密値を設定してください。

Claude

1. pip install mysql-mcp-serverでmysql-mcp-serverをインストールします。
2. claude_desktop_config.jsonファイルを編集します。
3. MySQL MCPサーバーの設定を追加します:

   {
     "mcpServers": {
       "mysql": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/mysql_mcp_server",
           "run",
           "mysql_mcp_server"
         ],
         "env": {
           "MYSQL_HOST": "localhost",
           "MYSQL_PORT": "3306",
           "MYSQL_USER": "your_username",
           "MYSQL_PASSWORD": "your_password",
           "MYSQL_DATABASE": "your_database"
         }
       }
     }
   }
   

4. ファイルを保存し、Claude Desktopを再起動します。
5. Claudeインターフェース上でサーバーが稼働・アクセス可能であることを確認します。

Cursor

1. MCPサーバーをpip install mysql-mcp-serverでインストールします。
2. Cursorの設定ファイルを開きます。
3. 下記のサーバー定義を追加します:

   {
     "mcpServers": {
       "mysql": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/mysql_mcp_server",
           "run",
           "mysql_mcp_server"
         ],
         "env": {
           "MYSQL_HOST": "localhost",
           "MYSQL_PORT": "3306",
           "MYSQL_USER": "your_username",
           "MYSQL_PASSWORD": "your_password",
           "MYSQL_DATABASE": "your_database"
         }
       }
     }
   }
   

4. Cursorを再起動して新しいサーバーを検出させます。
5. サーバー接続が有効であることを検証します。

Cline

1. pip install mysql-mcp-serverでサーバーパッケージをインストールします。
2. Clineの設定ファイルを編集します。
3. 以下のようにサーバーを設定します:

   {
     "mcpServers": {
       "mysql": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/mysql_mcp_server",
           "run",
           "mysql_mcp_server"
         ],
         "env": {
           "MYSQL_HOST": "localhost",
           "MYSQL_PORT": "3306",
           "MYSQL_USER": "your_username",
           "MYSQL_PASSWORD": "your_password",
           "MYSQL_DATABASE": "your_database"
         }
       }
     }
   }
   

4. 設定を保存し、Clineを再起動します。
5. クライアント画面でサーバー接続をテストしてください。

APIキー保護例:

"env": {
  "MYSQL_HOST": "localhost",
  "MYSQL_PORT": "3306",
  "MYSQL_USER": "your_username",
  "MYSQL_PASSWORD": "your_password",
  "MYSQL_DATABASE": "your_database"
}

機密情報はenvセクションで管理し、他の場所でハードコーディングしないようにしてください。

このMCPをフロー内で使用する方法

FlowHuntでMCPを活用する

MCPサーバーをFlowHuntワークフローへ統合するには、まずMCPコンポーネントをフローに追加し、AIエージェントと接続します。

MCPコンポーネントをクリックして設定パネルを開き、システムMCP設定セクションに下記JSON形式でMCPサーバーの情報を入力します。

{
  "mysql": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AIエージェントはこのMCPをツールとして利用し、全機能にアクセスできます。mysql部分は実際のMCPサーバー名に、URLも自身のMCPサーバーURLに適宜書き換えてください。

概要

当社の見解

MySQL MCPサーバーは、安全なデータベースアクセスのために特化された堅牢なMCP実装であり、明確な設定・セキュリティ機能を備えています。ただし、プロンプトテンプレートやサンプリング・rootsなどの高度なMCP機能には対応していません。それでも、十分なドキュメント、リソース公開、ツールセットを持つため、データベース連携型AI用途には実用的な選択肢です。

MCPスコア