Spring AI、DeepSeek 与 MCP：对话驱动的接口查询新范式

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-openai-spring-boot-starter</artifactId>
    <version>1.0.0-M6</version>
</dependency>
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-mcp-client-spring-boot-starter</artifactId>
    <version>1.0.0-M6</version>
</dependency>
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-mcp-server-webmvc-spring-boot-starter</artifactId>
    <version>1.0.0-M6</version>
</dependency>
<!-- Optional: For using the OpenAI API -->
<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
    <version>5.2.1</version>
</dependency>

spring:
  ai:
    openai:
      api-key: ${your-deepseek-api-key}
      chat:
        base-url: https://api.deepseek.com
        completions-path: /v1/chat/completions
        options:
          model: deepseek-chat

• ChatClientConfig@Configuration
public class ChatClientConfig {
 @Bean
 public ChatClient chatClient(ChatClient.Builder builder) {
 return builder.build();
  }
}

• ChatController/**
 * 聊天控制器，处理AI聊天请求
 */
@RestController
@RequestMapping("/api/chat")
@RequiredArgsConstructor
publicclassChatController {

 privatestaticfinalLoggerLOGGER= LoggerFactory.getLogger(ChatController.class);

 @Resource
 private ChatClient chatClient;

 /**
     * 处理聊天请求，使用AI和MCP工具进行响应
     *
     * @param request 聊天请求
     * @return 包含AI回复的响应
     */
 @PostMapping
 public ResponseEntity<ChatResponse> chat(@RequestBody ChatRequest request) {
 try {
 // 创建用户消息
 Stringmessage= request.getMessage();
 // 使用非流式 API 调用聊天
 Stringcontent= chatClient.prompt()
                    .user(message)
                    .call()
                    .content();
 return ResponseEntity.ok(newChatResponse(content));
        } catch (Exception e) {
            LOGGER.error("Chat request failed", e);
 return ResponseEntity.ok(newChatResponse("处理请求时出错: " + e.getMessage()));
        }
    }
} 

package com.glmapper.mcp.service;

import com.glmapper.mcp.model.Book;
import com.glmapper.mcp.repository.BookRepository;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

/**
 * @Classname BookService
 * @Description BookService
 * @Date 2025/4/3 14:14
 * @Created by glmapper
 */
@Service
publicclassBookService {

    @Autowired
    private BookRepository bookRepository;
        
    @Tool(name = "findBooksByTitle", description = "根据书名模糊查询图书，支持部分标题匹配")
    public List<Book> findBooksByTitle(@ToolParam(description = "书名关键词") String title) {
        return bookRepository.findByTitleContaining(title);
    }

    @Tool(name = "findBooksByAuthor", description = "根据作者精确查询图书")
    public List<Book> findBooksByAuthor(@ToolParam(description = "作者姓名") String author) {
        return bookRepository.findByAuthor(author);
    }

    @Tool(name = "findBooksByCategory", description = "根据图书分类精确查询图书")
    public List<Book> findBooksByCategory(@ToolParam(description = "图书分类") String category) {
        return bookRepository.findByCategory(category);
    }
}

/**
 * MCP服务器配置类，负责注册MCP工具
 */
@Configuration
public class McpServerConfig {

 /**
     * 注册工具回调提供者，将BookService中的@Tool方法暴露为MCP工具
     *
     * @param bookService 图书服务
     * @return 工具回调提供者
     */
 @Bean
 public MethodToolCallbackProvider bookToolCallbackProvider(BookService bookService) {
 return MethodToolCallbackProvider.builder().toolObjects(bookService).build();
    }
}

@Configuration
publicclassChatClientConfig {

 @Autowired
 private ToolCallbackProvider bookToolCallbackProvider;

 /**
     * 配置ChatClient，注册系统指令和工具函数
     */
 @Bean
 public ChatClient chatClient(ChatClient.Builder builder) {

 //return builder.build();
 return builder
                .defaultSystem("你是一个图书管理助手，可以帮助用户查询图书信息。" +
 "你可以根据书名模糊查询、根据作者查询和根据分类查询图书。" +
 "回复时，请使用简洁友好的语言，并将图书信息整理为易读的格式。")
 // 注册工具方法
                .defaultTools(bookToolCallbackProvider)
                .build();
    }
}

// 准备示例数据
List<Book> sampleBooks = Arrays.asList(
        newBook(null, "Spring实战（第6版）", "编程", "Craig Walls",
                LocalDate.of(, , ), "9787115582247"),
        newBook(null, "深入理解Java虚拟机", "编程", "周志明",
                LocalDate.of(, , ), "9787111641247"),
        newBook(null, "Java编程思想（第4版）", "编程", "Bruce Eckel",
                LocalDate.of(, , ), "9787111213826"),
        newBook(null, "算法（第4版）", "计算机科学", "Robert Sedgewick",
                LocalDate.of(, , ), "9787115293800"),
        newBook(null, "云原生架构", "架构设计", "张三",
                LocalDate.of(, , ), "9781234567890"),
        newBook(null, "微服务设计模式", "架构设计", "张三",
                LocalDate.of(, , ), "9789876543210"),
        newBook(null, "领域驱动设计", "架构设计", "Eric Evans",
                LocalDate.of(, , ), "9787111214748"),
        newBook(null, "高性能MySQL", "数据库", "Baron Schwartz",
                LocalDate.of(, , ), "9787111464747"),
        newBook(null, "Redis实战", "数据库", "Josiah L. Carlson",
                LocalDate.of(, , ), "9787115419378"),
        newBook(null, "深入浅出Docker", "容器技术", "李四",
                LocalDate.of(, , ), "9787123456789")
);