Java Spring Mysql MCP Server

🚀 Spring Boot MySQL 項目

這是一個使用 MySQL 和 HikariCP 連接池配置的 Spring Boot 項目，藉助 Spring Boot 的便捷特性和 MySQL 的強大數據存儲能力，能高效地開發數據庫相關應用。

🚀 快速開始

先決條件

• 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 上運行。

📦 安裝指南

此項目的安裝主要依賴於上述的先決條件和設置步驟，確保您的開發環境滿足 Java、Maven 和 MySQL 的版本要求，並正確創建數據庫和配置憑證。

💻 使用示例

在 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 文件中。

📚 詳細文檔

配置

該應用程序使用以下主要配置：

您可以在 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'

⚠️ 重要提示

請確保在運行項目前正確配置數據庫憑證和相關參數，避免因配置錯誤導致應用程序無法正常運行。

💡 使用建議

可以根據實際需求調整 HikariCP 連接池大小和 Hibernate 的 ddl-auto 配置，以優化應用程序的性能和數據庫操作。