MySQL MCP Server

MySQL MCP サーバー

MySQL データベースへの読み取り専用アクセスを提供する Model Context Protocol サーバーです。このサーバーを使用すると、LLM はデータベースのスキーマを調べ、読み取り専用クエリを実行できます。

認証

このサーバーは、データベース URL を通じた MySQL 認証に対応しています。URL の形式は次のとおりです。

mysql://username:password@host:port/database

例：

• DB：mysql://user:pass@localhost:3306/mydb

注：認証情報は常に適切に保護し、公開設定で露出しないようにしてください。

コンポーネント

ツール

• query
  • 接続先データベースに対して読み取り専用の SQL クエリを実行します
  • 入力：sql（文字列）：実行する SQL クエリ
  • すべてのクエリは READ ONLY トランザクション内で実行されます
  • 認証は指定された認証情報を使用して自動的に行われます

リソース

このサーバーは、データベース内の各テーブルのスキーマ情報を提供します。

• テーブルスキーマ（mysql://<host>/<table>/schema）
  • 各テーブルの JSON スキーマ情報
  • 列名とデータ型を含みます
  • データベースのメタデータから自動的に検出されます
  • 指定された認証情報を使用してアクセスを認証します

インストール

1. リポジトリをクローンします：

git clone https://github.com/yourusername/mysql-mcp-server.git
cd mysql-mcp-server

2. 依存関係を準備してインストールします：

npm run prepare
npm install

3. グローバルリンクを作成します：

npm link

これで、ターミナルのどこからでも mysql-mcp-server コマンドを使用できます：

mysql-mcp-server mysql://user:password@localhost:3306/mydb

Cursor での使用方法

Cursor での MCP の設定

1. Cursor の設定を開きます：

   • Cursor の左下隅にある歯車アイコン（⚙️）をクリックします
   • または、macOS で Shift + Cmd + J を押します

2. MCP サーバーを設定します：

   • 左側のサイドバーで「MCP」をクリックします
   • 「Add Global MCP Server」をクリックします
   • 次の設定を追加します：

{
  "mcpServers": {
    "mysql": {
      "command": "mysql-mcp-server",
      "args": ["mysql://user:password@localhost:3306/mydb"]
    }
  }
}

3. 設定を保存します：
   • 「Save」をクリックするか、Cmd + S を押します
   • 変更を反映するため、Cursor を再起動します

Cursor での使い方

Cursor でエージェントチャットを開き、DB に関する質問を始めると、必要なコンテキストがすべて利用できます。

セキュリティのベストプラクティス

1. 機密性の高い認証情報には環境変数を使用します：

   {
     "mcpServers": {
       "mysql": {
         "command": "mysql-mcp-server",
         "args": ["mysql://${MYSQL_USER}:${MYSQL_PASSWORD}@host:3306/mydb"]
       }
     }
   }
   

2. MySQL ユーザーに必要最小限の権限（読み取り専用アクセス）を設定します

3. 強力なパスワードを使用し、セキュリティのベストプラクティスに従います

4. 認証情報を含む設定ファイルをバージョン管理にコミットしないでください

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。MIT ライセンスの利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。