Spring Boot MySQL Project について
Spring Boot MySQL Projectは、MySQLとHikariCPを使うよう構成されたJavaアプリケーションです。データベース接続が必要なクライアント向けに、stdio経由のMCPサーバーとして実行できます。
主な機能
- 01Spring BootとMySQLの設定
- 02HikariCP接続プール
- 03Hibernateによるスキーマ更新
- 04stdioサーバー設定
活用シーン
- 01MCPクライアントからのMySQL接続
- 02MavenまたはJARによるアプリ実行
- 03MCP Inspectorでのテストとデバッグ
MCP 対応
このプロジェクトはstdio経由でMCPサーバーとして動作し、MCPクライアントに設定できます。READMEにはテストとデバッグ用のMCP Inspectorコマンドが記載されています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Spring Boot MySQL プロジェクト
これは、MySQL と HikariCP 接続プールを設定した Spring Boot プロジェクトです。
前提条件
- Java 17 以降
- Maven 3.6 以降
- MySQL 8.0 以降
セットアップ
demoという名前の MySQL データベースを作成します:
CREATE DATABASE demo;
- デフォルトと異なる場合は、
src/main/resources/application.propertiesのデータベース認証情報を更新します:
- ユーザー名:root
- パスワード:root
アプリケーションの実行
- プロジェクトをビルドします:
mvn clean install
- アプリケーションを実行します:
mvn spring-boot:run
または
java -jar path/to/jar/java-mysql-mcp-0.0.1-SNAPSHOT.jar
アプリケーションは http://localhost:8080 で起動します。
設定
アプリケーションでは、次の主な設定を使用します:
- サーバーポート:8080
- HikariCP 接続プールサイズ:10
- Hibernate ddl-auto:update(データベーススキーマを自動的に更新します)
これらの設定は src/main/resources/application.properties で変更できます。
stdio 経由でサーバーに接続するには、spring.main.web-application-type: none が必須です。設定しない場合、次のエラーが発生します:
2025-03-25T09:21:30.352-03:00 WARN 25352 --- [main] ConfigServletWebServerApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.context.ApplicationContextException: Failed to start bean 'webServerStartStop'
MCP クライアントでの使用方法
db.hostenv の値はデータベースサーバーのホストとポートです。例:host:port、たとえば localhost:3306。
{
"mcpServers": {
"blue-hero-database": {
"command": "java",
"args": [
"-Dspring.ai.mcp.server.stdio=true",
"-Dserver.port=8080",
"-Ddb.hostenv=host:port",
"-Ddb.schema=/demo",
"-Ddb.user=username",
"-Ddb.passwordenv=password",
"-jar",
"/path/to/java-mysql-mcp/target/java-mysql-mcp-0.0.1-SNAPSHOT.jar"
]
}
}
}
デバッグ
次のコマンドを使用して、mcp inspector でテストとデバッグを行えます:
npx @modelcontextprotocol/inspector java -Dspring.ai.mcp.server.stdio=true -jar /path/to/project/target/java-mysql-mcp-0.0.1-SNAPSHOT.jar
ログ出力は ./mcp-mysql-stdio-server.log に作成されます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。