# multiple-mysql-mcp

**Repository Path**: chaoyangli/multiple-mysql-mcp

## Basic Information

- **Project Name**: multiple-mysql-mcp
- **Description**: MySQL MCP Server

基于 Spring AI 开发的本地 MySQL MCP 服务，支持多数据库连接、启动校验、健康检查。通过环境变量配置，开箱即用。

提供三类服务：Query（查询）、DDL（结构管理）、DML（增删改）。
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/chaoyangli/multiple-mysql-mcp
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-03-21
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MCP, MCP-Server, spring-ai-mpc, Java

## README

# Multiple MySQL MCP Server

基于 Spring AI 实现的 MySQL MCP Server，支持多数据库连接管理。

## 功能特性

- **多数据库连接管理**：支持配置多个MySQL数据库
- **连接校验**：启动时自动校验连接有效性
- **健康检查**：定时检测连接状态，自动重连
- **三个独立服务**：
  - Query Service：SELECT查询
  - DDL Service：表结构管理
  - DML Service：数据增删改

## 快速开始

### 1. 配置数据库连接

编辑 `src/main/resources/application.yml`：

```yaml
mysql:
  mcp:
    databases:
      - name: db_primary
        host: localhost
        port: 3306
        username: root
        password: your_password
        database: myapp
```

### 2. 构建项目

```bash
mvn clean package -DskipTests
```

### 3. 运行服务

```bash
java -jar target/multiple-mysql-mcp-1.0.0.jar
```

### 4. 配置 MCP Client

编辑 `mcp-config.json`：

```json
{
  "mcpServers": {
    "multiple-mysql-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/Users/ran/licy/software/multiple-mysql-mcp-1.0.0.jar"
      ],
      "env": {
        "MYSQL_DB_COUNT": "2",
        "MYSQL_DB_HOST": "localhost",
        "MYSQL_DB_PORT": "3306",
        "MYSQL_DB_USERNAME": "root",
        "MYSQL_DB_PASSWORD": "12345678",
        "MYSQL_DB_DATABASE": "test",
        "MYSQL_DB_2_HOST": "localhost",
        "MYSQL_DB_2_PORT": "3306",
        "MYSQL_DB_2_USERNAME": "root",
        "MYSQL_DB_2_PASSWORD": "12345678",
        "MYSQL_DB_2_DATABASE": "test2"
      }
    }
  }
}
```

## 可用工具

### Query Service

| 工具名称 | 说明 |
|---------|------|
| `query_select` | 执行SELECT查询 |
| `query_show_tables` | 查看所有表 |
| `query_describe` | 查看表结构 |
| `test_connection` | 测试连接 |
| `list_databases` | 列出配置的数据库 |

### DDL Service

| 工具名称 | 说明 |
|---------|------|
| `ddl_create_table` | 创建表 |
| `ddl_drop_table` | 删除表 |
| `ddl_alter_table` | 修改表结构 |
| `ddl_create_index` | 创建索引 |
| `ddl_drop_index` | 删除索引 |

### DML Service

| 工具名称 | 说明 |
|---------|------|
| `dml_insert` | 插入数据 |
| `dml_update` | 更新数据 |
| `dml_delete` | 删除数据 |
| `dml_replace` | 替换数据 |

## 配置选项

```yaml
mysql:
  mcp:
    databases:
      - name: db_name
        host: localhost
        port: 3306
        username: root
        password: password
        database: myapp
    health-check:
      enabled: true
      interval: 30000  # 健康检查间隔(毫秒)
    pool:
      maximum-pool-size: 10
      minimum-idle: 2
      connection-timeout: 30000
    query:
      timeout: 30000
      max-rows: 1000
```