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 配置，以优化应用程序的性能和数据库操作。