保姆级Spring Boot + 最新版Spring AI集成MCP（带有权限认证）并通过自定义注解实现包含Tool对象注入的方式-CSDN博客

1. server端

当前实现的不是响应式。
当前未直接整合大模型，会循序渐进的将整个相关体系更新完毕。

1.1 目录结构

在这里插入图片描述

JDK最低为17，OpenJDK17下载地址:https://www.oracle.com/cn/java/technologies/downloads/#java17
依赖

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.5.5</version>
        <relativePath/>
    </parent>
        <properties>
        <java.version>17</java.version>
        <spring-ai-starter-mcp.version>1.0.0</spring-ai-starter-mcp.version>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>

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

        <!-- Lombok (可选，用于简化代码) -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>

1.2 大模型调用业务实现

1.2.1 获取当前城市的位置信息

MCPTool是自定义注解，在此步骤可以先忽略此注解

import com.example.springaimcp.annotation.MCPTool;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;

/**
 * @Author: Kenan
 * @Date: 2025-08-24 10:02
 * @Description: 天气MCP服务，提供天气信息获取功能
 */
@MCPTool(description = "位置工具服务")
public class LocationMCPService {

    @Tool(description = "获取指定位置的天气信息")
    public String getLocation(@ToolParam(description = "位置") String location) {
        // 模拟获取位置信息
        // 生成随机经纬度
        double latitude = -90 + Math.random() * 180;
        double longitude = -180 + Math.random() * 360;
        return String.format("The location %s is at latitude %.6f and longitude %.6f.", location, latitude, longitude);
    }
}

1.2.2 对话

import com.example.springaimcp.annotation.MCPTool;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;
import org.springframework.stereotype.Service;

/**
 * @Author: Kenan
 * @Date: 2025-08-24 11:17
 * @Description:
 */
@Service
@MCPTool(description = "对话服务")
public class ChatMCPService {

    @Tool(description = "你是谁")
    public String chat(@ToolParam(description = "模型名称") String userMessage) {
        return "我是MCP DEMO";
    }
}

1.3 注入TOOL相关对象

被注释的是官方目前提供的最新写法。没被注释的代码是通过自定义注释实现的注入对象的方式，否则一个一个的注入太麻烦了，没太理解为什么官方只提供一个一个注入的方式。
自定义注解

import org.springframework.stereotype.Component;

import java.lang.annotation.*;

/**
 * @Author: Kenan
 * @Date: 2025-08-24 10:15
 * @Description: 标识MCP工具的自定义注解，用于自动将bean注入到toolObjects中
 */
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface MCPTool {
    
    /**
     * 工具描述
     */
    String description() default "";
}

注入Bean对象

import com.example.springaimcp.annotation.MCPTool;
import com.example.springaimcp.service.ChatMCPService;
import com.example.springaimcp.service.LocationMCPService;
import lombok.AllArgsConstructor;
import org.springframework.ai.tool.ToolCallbackProvider;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.method.MethodToolCallbackProvider;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.lang.reflect.Method;

/**
 * @Author: Kenan
 * @Date: 2025-08-24 10:07
 * @Description: 注册工具回调提供者，自动扫描带有@MCPTool注解的bean
 */
@Configuration
// @AllArgsConstructor
public class MCPToolCallbackProviderRegister {

    // 老式写法
    // private final LocationMCPService locationMCPService;
    // private final ChatMCPService chatMCPService;

    @Bean
    public ToolCallbackProvider mcpCallbackProvider(ApplicationContext applicationContext) {
        // 获取所有带有@MCPTool注解的bean，并过滤出包含@Tool方法的bean
        Object[] toolObjects = applicationContext.getBeansWithAnnotation(MCPTool.class)
                .values()
                .stream()
                .filter(this::hasToolAnnotatedMethods)
                .toArray();

        // 使用Stream API将所有toolObjects添加到builder中
        MethodToolCallbackProvider.Builder builder = MethodToolCallbackProvider.builder();
        builder.toolObjects(toolObjects);

        return builder.build();
    }

    /**
     * 检查对象是否包含@Tool注解的方法
     */
    private boolean hasToolAnnotatedMethods(Object obj) {
        Method[] methods = obj.getClass().getDeclaredMethods();
        for (Method method : methods) {
            if (method.isAnnotationPresent(Tool.class)) {
                return true;
            }
        }
        return false;
    }

    // @Bean
    // public ToolCallbackProvider unifiedMCPProvider(LocationMCPService locationMCPService, ChatMCPService chatMCPService) {
    //     return MethodToolCallbackProvider.builder()
    //             .toolObjects(locationMCPService, chatMCPService)
    //             .build();
    // }
}

1.4 配置文件等信息

server:
  port: 8081

spring:
  ai:
    mcp:
      server:
        base-url: /ai
  mvc:
    servlet:
      path: /ai

1.5 权限

通过Interceptor获取请求头等信息（实际生产中不要使用sout打日志…）
实际的鉴权逻辑根据自己的业务而定，接着注释继续往下写即可

import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;

/**
 * @Author: Kenan
 * @Date: 2025-08-24 10:23
 * @Description: 鉴权拦截器
 */
@Component
public class AuthInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        String authorization = request.getHeader("Authorization");
        System.out.println("Authorization: " + authorization);
        String requestURI = request.getRequestURI();
        System.out.println("URI: " + requestURI);

        // 鉴权逻辑(可以根据实际的业务进行补充)


        return true;
    }
}

将拦截器注入到config当中

import com.example.springaimcp.interceptor.AuthInterceptor;
import lombok.AllArgsConstructor;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * @Author: Kenan
 * @Date: 2025-08-24 10:30
 * @Description:
 */
@Configuration
@AllArgsConstructor
public class WebConfig implements WebMvcConfigurer {

    private final AuthInterceptor authInterceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(authInterceptor)
                // 放行的是ping、请求路由
                .addPathPatterns("/ai/sse", "/ai/mcp/message");
    }
}

1.6 运行与调试

访问github了解一下modelcontextprotocol/inspector:https://github.com/modelcontextprotocol/inspector
如果不会访问可直接按照下面的步骤
- 运行后端服务
- 本地的Node.js: ^22.7.5要大于等于这个版本
- 控制台运行npx @modelcontextprotocol/inspector
打开链接http://127.0.0.1:6274
复制图片中MCP_PROXY_AUTH_TOKEN后面的参数
点击Connect
其实大模型识别的就是@Tool(description = "获取指定位置的天气信息")这部分的内容