​

MCP 服务器启动器文档

​

概述

• 自动配置 MCP 端点。
• 用于处理 MCP 请求的组件。
• 与 Spring Boot 应用程序的无缝集成。

​

入门

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

​

配置

​

服务器属性

• spring.ai.mcp.server.enabled: 启用或禁用 MCP 服务器 (默认为 true)。
• spring.ai.mcp.server.path: MCP API 端点的基础路径 (默认为 /mcp)。
• spring.ai.mcp.server.port: MCP 服务器监听的端口 (默认为应用程序的服务器端口)。

spring.ai.mcp.server.path=/api/mcp

​

模型配置

spring.ai.openai.api-key=YOUR_OPENAI_API_KEY
spring.ai.openai.chat.options.model=gpt-4o

​

用法

​

MCP 端点

​

处理程序

​

自定义 McpChatHandler

@Bean
public McpChatHandler customMcpChatHandler(ChatModel chatModel) {
    // 自定义逻辑
    return new McpChatHandler(chatModel, new McpChatOptions(), null);
}

​

请求和响应格式

​

示例：创建一个简单的 MCP 服务器

1. 添加依赖项：如上所述，将 spring-ai-mcp-server-boot-starter 和模型特定的启动器 (例如，spring-ai-openai-spring-boot-starter) 添加到您的 pom.xml 中。
2. 配置属性：在 application.properties 中配置您的 AI 模型凭证和可选的 MCP 服务器属性。
   # OpenAI 配置
   spring.ai.openai.api-key=YOUR_OPENAI_API_KEY
   spring.ai.openai.chat.options.model=gpt-4o
   
   # MCP 服务器配置 (可选)
   # spring.ai.mcp.server.path=/custom-mcp-path
   
3. 运行应用程序：启动您的 Spring Boot 应用程序。

​

安全性

1. 添加 Spring Security 依赖项：
   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-security</artifactId>
   </dependency>
   
2. 配置安全规则：
   import org.springframework.context.annotation.Bean;
   import org.springframework.context.annotation.Configuration;
   import org.springframework.security.config.annotation.web.builders.HttpSecurity;
   import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
   import org.springframework.security.core.userdetails.User;
   import org.springframework.security.core.userdetails.UserDetails;
   import org.springframework.security.provisioning.InMemoryUserDetailsManager;
   import org.springframework.security.web.SecurityFilterChain;
   
   import static org.springframework.security.config.Customizer.withDefaults;
   
   @Configuration
   @EnableWebSecurity
   public class SecurityConfig {
   
       @Bean
       public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
           http
               .authorizeHttpRequests(authorizeRequests ->
                   authorizeRequests
                       .requestMatchers("/mcp/**").authenticated() // 保护 MCP 端点
                       .anyRequest().permitAll()
               )
               .httpBasic(withDefaults());
           return http.build();
       }
   
       @Bean
       public InMemoryUserDetailsManager userDetailsService() {
           UserDetails user = User.withDefaultPasswordEncoder()
               .username("user")
               .password("password")
               .roles("USER")
               .build();
           return new InMemoryUserDetailsManager(user);
       }
   }
   

​

故障排除

• 404 未找到：验证 MCP 端点路径是否正确配置，并且您的应用程序是否正在运行。
• 身份验证错误：确保您的 AI 模型凭证正确无误且具有必要的权限。
• 依赖项冲突：检查您的 pom.xml 是否存在可能导致问题的冲突依赖项。