mcp-server-Sql

mcp-server-Sql

site icon
2025.04.06 2
Java数据库服务SQL自动化工具数据库
mcp-server-sql 是一个基于Spring Boot的SQL服务应用,作为Spring AI MCP框架的一部分,主要用于执行SQL查询和更新操作,并将结果写入文件。它支持自定义数据库连接配置,适用于需要自动化SQL操作和数据导出的场景。
View on GitHub

Overview

基本能力

产品定位

mcp-server-sql 是一个专注于SQL查询和更新操作的自动化工具,旨在简化数据库操作流程,提高开发效率。

核心功能

  • 执行SQL查询并将结果写入CSV文件
  • 执行SQL更新操作(INSERT, UPDATE, DELETE)并返回影响的行数
  • 支持自定义数据库连接配置
  • 集成Spring AI MCP框架,可作为AI工具使用

适用场景

  • 自动化数据导出:将数据库查询结果导出为CSV文件,便于后续分析或处理。
  • 批量数据更新:通过API批量执行SQL更新操作,减少手动操作的工作量。
  • 数据库维护:定期执行SQL脚本进行数据库维护或数据清理。

工具列表

  • SQL查询工具:执行SQL查询并将结果写入CSV文件。
  • SQL更新工具:执行SQL更新操作并返回影响的行数。

常见问题解答

  • 问题1:输出目录不存在或无权限创建。
  • 解决方案:确保输出目录存在或有权限创建。
  • 问题2:SQL查询结果格式问题。
  • 解决方案:SQL查询结果将以CSV格式保存,确保文件路径正确。
  • 问题3:数据库连接配置错误。
  • 解决方案:检查application.yml文件中的数据库连接配置是否正确。

使用教程

使用依赖

  1. 确保已安装Java 17和Maven。
  2. 配置MySQL 8.0数据库。

安装教程

  1. 克隆项目或下载源代码。
  2. application.yml文件中配置数据库连接信息:
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password
  1. 构建项目:
mvn clean package
  1. 运行应用:
java -jar target/mcp-server-Sql-1.0-SNAPSHOT.jar

调试方式

  1. 执行SQL查询:
{
  "sql": "SELECT * FROM users",
  "outputPath": "./output/users.csv"
}
  1. 执行SQL更新操作:
{
  "sql": "UPDATE users SET name='John' WHERE id=1",
  "outputPath": "./output/update_result.txt"
}
  1. 检查输出文件是否生成,并验证内容是否正确。

许可证

该项目遵循 None 开源许可条款。