Java Spring Mysql MCP Server

🚀 Spring Boot MySQL プロジェクト

このプロジェクトは、MySQLとHikariCP接続プールを使用して構成されたSpring Bootアプリケーションです。

🚀 クイックスタート

✨ 主な機能

• MySQLとHikariCP接続プールを用いたSpring Bootアプリケーションの構築
• データベースの自動更新機能
• MCPクライアントでの使用が可能

📦 インストール

前提条件

• Java 17 以上
• Maven 3.6 以上
• MySQL 8.0 以上

手順

1. demo という名前のMySQLデータベースを作成します。

CREATE DATABASE demo;

2. データベースの認証情報がデフォルト値と異なる場合は、src/main/resources/application.properties で更新します。
   • ユーザー名: root
   • パスワード: root

💻 使用例

アプリケーションの実行

1. プロジェクトをビルドします。

mvn clean install

2. アプリケーションを実行します。

mvn spring-boot:run

または

java -jar path/to/jar/java-mysql-mcp-0.0.1-SNAPSHOT.jar

アプリケーションは http://localhost:8080 で実行されます。

設定

このアプリケーションは以下の主な設定を使用しています。

これらの設定は src/main/resources/application.properties で変更できます。

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チェックツールを使用してテストとデバッグを行うことができます。以下のコマンドを実行します。

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 ファイルに作成されます。