MCP MySQL Server

Um servidor MCP baseado em Spring AI que executa consultas SQL arbitrárias contra um banco de dados MySQL configurado.

Documentação

Servidor MCP MySQL

Um MCP baseado em Spring AI que pode executar SQL arbitrário.

Para suporte a outros bancos de dados, consulte mcp-db-server

Documentação em Chinês | Documentação em Inglês

Início Rápido

1. Configuração JSON do MCP

Método 1: Inicialização via Maven Wrapper

{
  "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"
      ]
    }
  }
}

Método 2: Inicialização via arquivo JAR

Compile o jar

./mvnw clean package

Configure o servidor 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"
      ]
    }
  }
}

Observação: O parâmetro -Dloader.path é opcional e só precisa ser especificado quando for necessário executar funcionalidades de extensão.

2. Configuração da Fonte de Dados

Modifique o arquivo 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  # 标记为默认数据源

Recursos

  • Suporte a múltiplas fontes de dados - Configure e gerencie várias fontes de dados de banco
  • Alternância dinâmica de fontes de dados - Alterne dinamicamente entre diferentes fontes de dados em tempo de execução
  • Funcionalidades de extensão - Estenda funcionalidades por meio de scripts Groovy
  • Controle de segurança SQL - Evite que modelos de IA executem operações SQL perigosas

Documentação Detalhada

DocumentaçãoDescrição
Documentação de Funcionalidades de ExtensãoGuia detalhado de configuração e desenvolvimento para extensões de script Groovy
Documentação de Configuração de Fonte de DadosConfiguração detalhada de fontes de dados, gerenciamento de múltiplos ambientes e melhores práticas
Documentação de Controle de Segurança SQLConfiguração e gerenciamento de políticas de segurança SQL

Requisitos de Ambiente

  • JDK 21+
  • Maven 3.6+