# dbmasterserver

**Repository Path**: yluoyu/dbmasterserver

## Basic Information

- **Project Name**: dbmasterserver
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-05-19
- **Last Updated**: 2025-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DatabaseMaster

> **AI‑powered MySQL management tool**  
> 利用 Java、Spring AI 和 MCP 实现的“数据库大师”，通过自然语言对话即可分析表结构、生成并执行 SQL、并以 Markdown 格式返回结果。

---

## 项目概述

DatabaseMaster 是一个基于 **Java 17**、**Spring Boot 3.x**、**Spring AI MCP** 的开源项目。  
它将 **Model Context Protocol (MCP)** 与 Spring AI 无缝集成，使得后端能够暴露数据库操作工具（`@Tool` 方法），前端通过对话方式驱动这些工具，完成对 MySQL 数据库的查询与分析。


### 前端地址
[前端页面地址](https://gitee.com/itwwf/dbmaster)


---

## 核心功能

- **意图理解**  
  从用户自然语言中识别查询意图，主动澄清歧义。
- **Schema‑Aware SQL 生成**  
  根据数据库表结构和用户需求，生成高效、可索引的 SQL 语句。
- **MCP 工具调用**  
  通过 MCP Java SDK 调用后端 `@Tool` 方法，执行 SQL 并获取结果
- **Markdown 输出**  
  以 Markdown 格式返回：
    - `#`,`##`,`###` 级标题
    - ```sql …``` 代码块
    - Markdown 表格展示结果集
    - 简要自然语言解读
- **前端渲染**  
  支持表格、代码高亮、Mermaid 图表等，基于 Vue3 + Element Plus 实现高质感对话界面。

---

## 技术栈

- **Java 17**, **Spring Boot 3.x**

- **Spring AI MCP** (`spring‑ai‑mcp‑server‑spring‑boot‑starter`) :contentReference[oaicite:1]{index=1}

- **MCP Java SDK**：Model Context Protocol 的 Java 实现

- **MyBatis‑Plus** / **JdbcTemplate**：MySQL 操作

- **Vue 3**, **Vite**, **Element Plus**：前端对话页面

- **markdown‑it** / **highlight.js** / **Mermaid**：Markdown 渲染与可视化

## 项目截图

​	![页面初始化](./doc/0.jpg)

![问答效果](doc/1.jpg)

![问答效果](doc/2.png)

![问答效果](doc/3.png)

![问答效果](doc/4.png)