MySQL MCPサーバーとは？

MySQL MCPサーバーは、Spring Bootに基づくミドルウェアサービスで、Model Context Protocol(MCP)プロトコルを実装し、MySQLデータベース操作を安全に実行するために専用に設計されています。これはデータベースとクライアントアプリケーションの間の橋渡し役となり、標準化されたデータアクセスインターフェースを提供します。

MySQL MCPサーバーの使い方は？

MCPクライアントをこのサーバーに接続するように設定することで、データベース操作要求を送信できます。サーバーは要求を検証し、安全なクエリ操作を実行し、フォーマットされた結果を返します。

適用シナリオ

MySQLデータベースを安全にアクセスする必要があるAIアシスタント、データ分析ツール、または標準化されたデータベースインターフェースが必要な任意のアプリケーションシナリオに適しています。

主な機能

安全なクエリSELECTクエリを実行し、結果を返します(4000文字を超える場合は自動的に切り捨てます)

テーブルリストの確認データベース内のすべてのテーブルの名前リストを取得します

テーブル構造の確認指定されたテーブルの詳細な構造情報（列名、データ型、制約など）を確認します

利点と制限

利点

標準化されたデータベースアクセスインターフェースを提供します

組み込みのセキュリティ機構があり、SELECTクエリのみを許可します

自動的に結果を切り捨てて、大量のデータ転送を防止します

Spring Bootに基づく軽量なデプロイが可能です

制限

MySQLデータベースのみをサポートします

機能はクエリに限定され、データの変更はサポートされません

Java実行環境が必要です

使い方

プロジェクトの構築

Mavenを使用してプロジェクトを構築し、実行可能なjarファイルを生成します

接続の設定

MCPクライアントの設定ファイルで、サーバーの起動コマンドとデータベースの接続情報を設定します

サービスの起動

設定したMCPクライアントを通じてサービスを起動します

使用例

ユーザーデータのクエリユーザーテーブルの最初の10件のレコードを取得します

データベースのテーブル構造の確認注文テーブルの構造情報を確認します

よくある質問

なぜ私のUPDATE文が実行できないのですか？

クエリ結果が切り捨てられた場合はどうすればいいですか？

異なるデータベースに接続するにはどうすればいいですか？

🚀 MySQL MCP サーバー

Spring Boot をベースに実装された MySQL データベース操作サーバーで、モデルコンテキストプロトコル（MCP）に準拠しています。

✨ 主な機能

SELECT クエリを実行する
データベース内のすべてのテーブル名を列挙する
テーブルのスキーマ情報を取得する

📚 詳細ドキュメント

API

ツール

query
- SELECT SQL クエリを実行し、結果を返します。
- 入力：sql (文字列)
- 返り値：クエリ結果のリスト（4000文字を超えると切り捨てられます）
- 注意：SELECT クエリのみ実行可能です。
listAllTablesName
- データベース内のすべてのテーブル名を列挙します。
- 入力：なし
- 返り値：テーブル名をカンマ区切りで並べた文字列
getTableSchema
- 特定のテーブルのスキーマ情報を取得します。
- 入力：tableName (文字列)
- 返り値：以下の内容をカンマ区切りで並べた列情報：
  - 列名
  - データ型
  - 空値制約
  - デフォルト値

📦 インストール

Maven を使用してビルドします。

mvn install

💻 使用例

基本的な使用法

Claude Desktop または Cline と一緒に使用する場合、以下の内容を mcp サーバーの設定ファイルに追加します。

{
  "mysql-server": {
    "command": "java",
    "args": [
      "-jar",
      "{{ProjectDirectory}}\\target\\mcp-mysql-server-1.0.0.jar"
    ],
    "env": {
      "SPRING_DATASOURCE_URL": "jdbc:mysql://username:password@localhost:3306/database"
    }
  }
}