MySQL MCP Server

MySQL MCP サーバー

MySQL データベースと連携し、LLM に安全なデータベースアクセス機能を提供する MCP サーバーの実装です。

機能

• 読み取り操作
  • 読み取り専用の SELECT クエリを実行
  • データベース内のすべてのテーブルを一覧表示
  • テーブル構造を表示
  • スキーマ情報を表示
• 書き込み操作
  • トランザクションに対応した INSERT／UPDATE／DELETE を実行
  • データの安全性を確保するパラメーター化クエリ
  • 影響を受けた行数と挿入 ID を返す
• セキュリティ
  • SELECT クエリの読み取り専用トランザクションモード
  • クエリ長と結果サイズの制限
  • パフォーマンスの監視とログ記録
  • トランザクションの自動処理

インストール

npm install -g @kevinwatt/mysql-mcp

Dive Desktop での使用

1. Dive Desktop で「+ Add MCP Server」をクリックします
2. 次の設定をコピーして貼り付けます：

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

3. 「Save」をクリックして MCP サーバーをインストールします

ツールのドキュメント

• mysql_query

  • 読み取り専用の SELECT クエリを実行
  • 入力：
    • sql（文字列）：実行する SQL SELECT クエリ
  • 制限：
    • クエリの最大長：4096 文字
    • 結果の最大行数：1000
    • クエリのタイムアウト：30 秒

• mysql_execute

  • データ変更操作を実行
  • 入力：
    • sql（文字列）：SQL 文（INSERT／UPDATE／DELETE）
    • params（配列、省略可）：SQL 文のパラメーター
  • 機能：
    • 影響を受けた行数を返す
    • 最後に挿入された ID を返す
    • トランザクションを自動処理

• list_tables

  • 現在のデータベース内のすべてのテーブルを一覧表示
  • 入力は不要です

• describe_table

  • テーブル構造を表示
  • 入力：
    • table（文字列）：構造を表示するテーブル名

使用例

LLM に次のように依頼します：

"Show me all tables in the database"
"Describe the structure of users table"
"Select all active users from the database"
"Insert a new record into orders table"

手動での起動

必要に応じて、サーバーを手動で起動します：

npx @kevinwatt/mysql-mcp

必要条件

• Node.js 18 以降
• MySQL Server
• MCP 対応の LLM サービス

ライセンス

MIT

作者

Dewei Yen

キーワード

• mcp
• mysql
• database
• dive
• llm
• ai