技术文档摘要

MCP MySQL 服务器

基于Spring AI的MCP，能够执行任何SQL。

关于其他数据库的支持，请参阅mcp-db-server

中文文档 | 英文文档

快速开始

1. MCP JSON 配置

方法 1：启动 Maven 包装器

{
  "mcpServers": {
    "mcp-mysql-server": {
      "command": "/Users/xin.y/IdeaProjects/mcp-mysql-server/mvnw",
      "args": [
        "-q",
        "-f",
        "/Users/xin.y/IdeaProjects/mcp-mysql-server/pom.xml",
        "spring-boot:run"
      ]
    }
  }
}

方法 2：JAR 包启动

构建 jar

./mvnw clean package

配置 MCP 服务器

{
  "mcpServers": {
    "mcp-mysql-server": {
      "command": "java",
      "args": [
        "-Dloader.path=/Users/xin.y/IdeaProjects/mcp-mysql-server/src/main/resources/groovy",
        "-jar",
        "/Users/xin.y/IdeaProjects/mcp-mysql-server/target/mcp-mysql-server-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

注意： 参数 -Dloader.path 是可选的，仅在需要运行扩展功能时指定。

2. 数据源配置

修改 mcp-mysql-server/src/main/resources/datasource.yml 文件：

datasource:
  datasources:
    your_db1_name:
      url: jdbc:mysql://localhost:3306/db1
      username: root
      password: password
      default: true  # 标记为默认数据源

---

特性

• 多数据源支持 - 配置和管理多个数据库数据源
• 动态数据源切换 - 在运行时动态切换不同的数据源
• 扩展功能 - 通过 Groovy 脚本扩展功能
• SQL 安全控制 - 防止 AI 模型执行危险的 SQL 操作

详细文档

文档	描述
扩展功能文档	Groovy 脚本扩展的详细配置和开发指南
数据源配置文档	数据源的详细配置、多环境管理和最佳实践
SQL 安全控制文档	SQL 安全策略的配置和管理

环境要求

• JDK 21+
• Maven 3.6+