Spring AI 1.0 GA！仅需3步开发一个MCP Server

Louis XIV原创2025/5/27...大约 6 分钟

千呼万唤始出来，Spring AI 1.0-GA 版本终于发布了！耽搁了几天简单研究了一遍，今天正式介绍一下这个里程碑版本。

官方手册奉上，英语强的可以自己看：https://docs.spring.io/spring-ai/reference/index.html

Spring AI提供了什么能力

Spring做为Java生态的老大，果然没让我失望，Spring AI提供的工具包非常强大，几乎涵盖了当前AI开发所需的所有技术。

当然Spring目标并不是做模型，而是在模型之上、应用之下做框架，来看看1.0版本提供了什么能力：

对话客户端API。Spring已经提供了便利的对话API工具，便于把用户的输入转化为对大模型的对话输入，并把大模型的输出返回给用户。只需写一个Controller就可以完成聊天对话功能
多模态支持。Spring把多模态消息都抽象成了Spring AI Message API，降低了多模态AI的开发成本
集成了业界几乎所有的大模型。Deepseek、GPT、Claude，只要能叫得出名字的，几乎都集成了。不过我在列表里没找到豆包、混元、千问，不知道是不是因为咱国内的模型在海外的名气还不够大，不足以得到Spring的关注。当然这里只是集成，不是免费用，每个模型还是需要注册token，需要自己掏钱的
MCP client/server。标题已经说了，下面手把手带你开发一个。
RAG的支持
向量数据库

好多新词我也是刚接触不是很懂，比如这个向量数据库（Vector Database），大意上是说用于RAG（Retrieval Augmented Generation）中的信息检索，大模型检索数据不能用关系型数据库，而是要用向量数据库。

当给定一个向量作为查询时，向量数据库会返回与查询向量“相似”的向量。

跟着我3步开发一个MCP Server

这么多功能，一次也讲不完，今天就重点说一个MCP Server如何开发。我自己尝试了一下，真就只需3步。

先简单说下需求：我想开发一个可以读取数据库建表语句的MCP Server，这样我只需告诉AI：“帮我基于xxx表生成repository层的实现代码”，AI会自动从MCP Server上找到表结构定义

第一步：引入依赖

Spring AI 1.0版本需要基于Spring Boot 3.4.x，你可以先到https://start.spring.io/生成一个最基本的脚手架。

然后在pom.xml中引入：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-bom</artifactId>
            <version>1.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- spring ai -->
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
    </dependency>
    <!-- spring jdbc -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>
    <!-- mysql 驱动 -->
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <version>8.3.0</version>
    </dependency>
</dependencies>

第二步：改一下默认配置

调整application.yml或application.properties

spring:
  ai:
    mcp:
      server:
        name: mcp-db-connect
        version: 0.0.1
        type: ASYNC
        sse-message-endpoint: /mcp/sse/message
  # 退化为STDIO模式需要关闭banner
  main:
    banner-mode: off
  application:
    name: db-connect
  datasource:
    url: jdbc:mysql://localhost:3306/mydb?useSSL=false&useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
    username: root
    password: root1234

# 退化为STDIO模式需要关闭控制台日志
logging:
  file:
    name: ./log/mcp-server.log

有几点说明：

MCP Server有2种模式：STDIO模式和SSE模式，STDIO可以认为是本地的一个命令行程序，SSE模式就是远程服务，默认端口8080
上面的代码中引入了webflux，默认就是SSE模式，可以退化为STDIO，需要关闭banner日志和关闭控制台日志
SSE模式可以使用springmvc也可以用webflux来实现，区别是webflux是响应式的（Reactive），在对话模式中对用户友好

第三步：简单写几行代码

开发一个可以连接数据库，获取表结构的Tool，代码如下：

一个MCP Server上可以有多个Tool，每个Tool表示一个可以调用的工具。

@Slf4j
@Component
public class DbConnectTool {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    @Tool(description = "获取表结构定义，参数是表名")
    public String getTableDefinition(String tableName) {
        log.info("get table definition: {}", tableName);
        String sql = "SHOW CREATE TABLE " + tableName;
        return jdbcTemplate.queryForObject(sql, (rs, rowNum) -> rs.getString("Create Table"));
    }
}

把Tool注册上去，加一个Bean即可

@Configuration
public class AppConfiguration {
    @Bean
    public ToolCallbackProvider toolCallbackProvider(DbConnectTool dbConnectTool) {
        return MethodToolCallbackProvider.builder()
                .toolObjects(dbConnectTool).build();
    }
}

相信我，就这么简单，已经开发完了！

验证一下MCP Server

我们尝试在Cursor中验证一下效果，首先需要配置MCP Server

修改mcp.json，这里如果用STDIO模式，就按照mcp-server-1来配（需要先打出jar包），如果用SSE模式，就按mcp-server-2来配（需要先启动Server），配完看一下上图显示绿灯就表示成功。

{
  "mcpServers": {
    "mcp-server-1": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-jar",
        "/path/to/mcp-db-connect-0.0.1-SNAPSHOT.jar"
      ],
      "type": "stdio"
    },
    "mcp-server-2": {
      "url": "http://localhost:8080/sse",
      "type": "sse"
    }
  }
}