百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

用 Spring AI Alibaba 开发了一款能连接 MySQL 的 MCP 服务,手把手教你

nanshan 2025-07-10 19:28 2 浏览 0 评论

免责声明

本文档(含所有案例、代码及参考资料)仅供学习交流与参考用途。未经严格测试及专业评估前,禁止直接复制、引用或用于任何实际场景。使用者应自行承担因不当使用所产生的全部风险及法律责任,作者及文档提供方概不负责。

直接看成品

数据库表

还能统计数量

数量对应上表中的行数,准确无误。

详细实现步骤

使用 IDEA 创建新的项目

注意:

  1. Spring Boot 版本需要 3.2.x
  2. JDK 版本 17
  3. Maven 版本:3.9.9(这里我直接用的最新的,我用 3.6.1 打包项目成 jar 包是不行的,各位自行测试吧。)

Maven 依赖

<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.4.4</version>
        <relativePath/>
    </parent>

<properties>
        <java.version>17</java.version>
        <!-- Spring AI -->
        <spring-ai.version>1.0.0-M6</spring-ai.version>
    </properties>

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-mcp-server-spring-boot-starter</artifactId>
            <version>${spring-ai.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>

        <!-- Connection Pool -->
        <dependency>
            <groupId>com.zaxxer</groupId>
            <artifactId>HikariCP</artifactId>
            <version>5.1.0</version>
        </dependency>
    </dependencies>

系统配置

spring:
  main:
    web-application-type: none  # Disable web for stdio mode
    banner-mode: off
  ai:
    mcp:
      server:
        stdio: true
        name: mysql-server
        version: 1.0.0

相关代码

启动类

import com.zaxxer.hikari.HikariDataSource;
import org.springframework.ai.tool.ToolCallbackProvider;
import org.springframework.ai.tool.method.MethodToolCallbackProvider;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;
import org.springframework.context.annotation.Bean;
import org.springframework.jdbc.core.JdbcTemplate;
import top.trysmile.javamcpmysql.service.MySqlService;

import javax.sql.DataSource;

@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
public class JavaMcpMysqlApplication {

    public static void main(String[] args) {
        SpringApplication.run(JavaMcpMysqlApplication.class, args);
    }

    @Bean
    public DataSource dataSource() {
        HikariDataSource dataSource = new HikariDataSource();
        dataSource.setJdbcUrl("jdbc:mysql://IP:PORT/database"); // Added common parameters
        dataSource.setUsername("username");
        dataSource.setPassword("password");
        return dataSource;
    }

    @Bean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }

    @Bean
    public MySqlService mySqlService(JdbcTemplate jdbcTemplate) {
        return new MySqlService(jdbcTemplate);
    }

    @Bean
    public ToolCallbackProvider toolCallbackProvider(MySqlService mySqlService) {
        return MethodToolCallbackProvider.builder()
                .toolObjects(mySqlService)
                .build();
    }
}

执行 SQL 语句

import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;

import java.util.List;
import java.util.Map;

@Service
public class MySqlService {
    private final JdbcTemplate jdbcTemplate;

    public MySqlService(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    @Tool(description = "Execute a SQL query and return results")
    public List<Map<String, Object>> executeQuery(
            @ToolParam(description = "SQL query to execute") String query) {
        try {
            return jdbcTemplate.queryForList(query);
        } catch (Exception e) {
            throw new RuntimeException("Error executing query: " + e.getMessage(), e);
        }
    }

    @Tool(description = "Execute an update SQL statement (INSERT, UPDATE, DELETE)")
    public int executeUpdate(
            @ToolParam(description = "SQL statement to execute") String sql) {
        try {
            return jdbcTemplate.update(sql);
        } catch (Exception e) {
            throw new RuntimeException("Error executing update: " + e.getMessage(), e);
        }
    }

    @Tool(description = "Get table schema information")
    public List<Map<String, Object>> getTableSchema(
            @ToolParam(description = "Table name") String tableName) {
        if (!tableName.matches("^[a-zA-Z0-9_]+#34;)) {
            throw new IllegalArgumentException("Invalid table name format.");
        }
        try {
            return jdbcTemplate.queryForList(
                    "SELECT column_name, data_type, is_nullable " +
                            "FROM information_schema.columns " +
                            "WHERE table_schema = database() AND table_name = ?", tableName);
        } catch (Exception e) {
            throw new RuntimeException("Error getting table schema: " + e.getMessage(), e);
        }
    }

    @Tool(description = "Count records in a table")
    public int countRecords(
            @ToolParam(description = "Table name") String tableName) {
        if (!tableName.matches("^[a-zA-Z0-9_]+#34;)) {
            throw new IllegalArgumentException("Invalid table name format.");
        }
        try {
            String sql = String.format("SELECT COUNT(*) FROM `%s`", tableName.replace("`", "``"));
            return jdbcTemplate.queryForObject(sql, Integer.class);
        } catch (Exception e) {
            throw new RuntimeException("Error counting records: " + e.getMessage(), e);
        }
    }
}

OK,系统服务代码、配置到这里就结束啦。

现在你可以尝试一下运行服务是否能启动。

注意

数据库相关连接信息记得更新。

开始使用 AI 客户端接入 MCP 工具服务

客户端使用:ChatWise

开始配置 MCP 服务

配置如下图:

-jar 这个命令参数后的一串,就是你 Java 服务 jar 包所处的位置。

验证是否集成成功

点击 “查看工具”,当加载成功以后,就能看见能使用的工具啦。

文章到这里就结束啦,如果你有任何疑问,欢迎评论私信我哦~

更多文章一键直达

冷不叮的小知识

相关推荐

雷军1994年写的老代码曝光,被称像诗一样优雅

大数据文摘授权转载自程序员的那些事雷军的代码像诗一样优雅↓↓↓有些网友在评论中质疑,说雷军代码不会是“屎”一样优雅吧。说这话的网友,也许是开玩笑的,也许是真没看过雷军写过的代码。在2011年的时候,我...

原创经验分享:低级bug耗费12小时Fix

调试某程序非常简单的程序,简单到认为不可能存在缺陷,但该BUG处理时间超过12小时:程序属于后台进程,监控系统每隔15秒检查外设IO状态,IO异常后发出报警或复位外设,外设都在linux下有/sys/...

SpringBoot实现的简单停车位管理系统附带导入和演示教程视频

这一次为大家带来的是简单的停车位管理系统,基于SpringBoot+Thymeleaf+Mybatis框架,这个系统相对来说比较简单,很容易学习并快速上手,因为逻辑很清晰,没有太复杂的代码逻辑,所以学...

一个开箱即用的代码生成器(代码自动生成工具开源)

今天给大家推荐一个好用的代码生成器,名为renren-generator,该项目附带前端页面,可以很方便的选择我们所需要生成代码的表。首先我们通过git工具克隆下来代码(地址见文末),导入idea。...

【免费开源】JeecgBoot单点登录源码全部开源了

JeecgBoot单点登录源码全部开源了,有需要的朋友可以来薅羊毛了。一、JeecgBoot介绍JeecgBoot是一款企业级的低代码平台!前后端分离架构SpringBoot2.x,SpringCl...

SpringBoot+JWT+Shiro+Mybatis实现Restful快速开发后端脚手架

作者:lywJee来源:cnblogs.com/lywJ/p/11252064.html一、背景前后端分离已经成为互联网项目开发标准,它会为以后的大型分布式架构打下基础。SpringBoot使编码配置...

为什么越来越多的人选择使用idea软件

IDEA软件是什么?IDEA软件是干什么的?为什么越来越多的人选择使用IDEA软件?IDEA软件,全称IntelliJIDEA,它是由JetBrains公司开发开发的一款功能强大的集成开发环境(ID...

开题报告大学生互助系统(附源码)java毕设

本系统(程序+源码)带文档lw万字以上文末可获取一份本项目的java源码和数据库参考。系统程序文件列表开题报告内容选题背景随着互联网技术的飞速发展,大学生群体对信息共享与互助的需求日益增长。关于大...

SpringBoot项目快速开发框架JeecgBoot——项目简介及系统架构!

项目简介及系统架构JeecgBoot是一款基于SpringBoot的开发平台,它采用前后端分离架构,集成的框架有SpringBoot2.x、SpringCloud、AntDesignof...

新手配电脑13代CPU怎么选择(新手配电脑13代cpu怎么选择好)

Intel第13代酷睿i3、i5、i7、i9系列处理器的核心参数、性能差异及适用群体的详细说明(以桌面端为例):一、13代酷睿全系参数对比(桌面端主流型号)参数i3-13100i5-13600Ki7-...

加速 SpringBoot 应用开发,官方热部署神器真带劲

平时使用SpringBoot开发应用时,修改代码后需要重新启动才能生效。如果你的应用足够大的话,启动可能需要好几分钟。有没有什么办法可以加速启动过程,让我们开发应用代码更高效呢?今天给大家推荐一款Sp...

基于微信小程序的移动端物流系统-计算机毕业设计源码+LW文档

摘要随着Internet的发展,人们的日常生活已经离不开网络。未来人们的生活与工作将变得越来越数字化,网络化和电子化。网上管理,它将是直接管理移动端物流系统app的最新形式。本论文是以构建移动端物流系...

springboot教务管理系统+微信小程序云开发附带源码

今天给大家分享的程序是基于springboot的管理,前端是小程序,系统非常的nice,不管是学习还是毕设都非常的靠谱。本系统主要分为pc端后台管理和微信小程序端,pc端有三个角色:管理员、学生、教师...

SpringBoot全家桶:23篇博客加23个可运行项目让你对它了如指掌

SpringBoot现在已经成为Java开发领域的一颗璀璨明珠,它本身是包容万象的,可以跟各种技术集成。本项目对目前Web开发中常用的各个技术,通过和SpringBoot的集成,并且对各种技术通...

Maven+JSP+Servlet+C3P0+Mysql实现的音乐库管理系统

本系统基于Maven+JSP+Servlet+C3P0+Mysql实现的音乐库管理系统。简单实现了充值、购买歌曲、poi数据导入导出、歌曲上传下载、歌曲播放、用户注册登录注销等功能。难度等级:简单技术...

取消回复欢迎 发表评论: