问题：如何正确引入spring-ai-starter-mcp-server依赖？

Question

**问题：如何正确引入spring-ai-starter-mcp-server依赖？** 在使用 Spring Boot 构建 AI 微服务时，开发者常需集成 `spring-ai-starter-mcp-server` 以支持模型控制协议（MCP）服务。然而，许多用户在引入该依赖时遇到版本冲突、依赖无法解析或与现有 Spring AI 模块不兼容的问题。常见疑问包括：应在哪个项目中引入该依赖？是否需要额外配置 Maven 或 Gradle 的仓库？是否与其他 Spring AI Starter 冲突？如何确保其与 Spring Boot 版本的兼容性？本文将详解如何正确引入并配置 `spring-ai-starter-mcp-server`，避免典型错误。

Answer 1

如何正确引入 spring-ai-starter-mcp-server 依赖？

在构建基于 Spring Boot 的 AI 微服务时，集成 spring-ai-starter-mcp-server 是支持模型控制协议（MCP）服务的关键步骤。然而，在实际操作中，开发者常遇到诸如版本冲突、依赖无法解析或与其他 Spring AI 模块不兼容的问题。本文将从多个角度深入剖析如何正确引入该依赖。

1. 确定使用场景与依赖作用

spring-ai-starter-mcp-server 主要用于搭建 MCP 协议的服务端点，适用于需要对外暴露模型控制接口的微服务模块。通常情况下，应在独立的微服务项目中引入该依赖，而不是与模型推理或客户端逻辑混用。

• 适用于：AI 模型管理平台、模型部署调度中心、模型运行时控制器等
• 不建议用于：纯模型调用客户端、前端网关层

2. Maven 或 Gradle 配置方式

当前 spring-ai-starter-mcp-server 尚未进入 Maven Central 官方仓库，需手动配置仓库地址。

Maven 配置示例：

<repositories>
    <repository>
        <id>spring-snapshots</id>
        <name>Spring Snapshots</name>
        <url>https://repo.spring.io/snapshot</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-starter-mcp-server</artifactId>
        <version>0.8.1-SNAPSHOT</version>
    </dependency>
</dependencies>

Gradle 配置示例：

repositories {
    maven { url 'https://repo.spring.io/snapshot' }
}

dependencies {
    implementation 'org.springframework.ai:spring-ai-starter-mcp-server:0.8.1-SNAPSHOT'
}

3. 版本兼容性分析

为确保与 Spring Boot 及其他 Spring AI 组件的兼容性，建议参考下表进行版本匹配：

Spring Boot 版本	Spring AI Starter MCP Server 版本	Spring AI Core 版本
3.0.x	0.8.1-SNAPSHOT	0.8.1
2.7.x	0.7.0	0.7.0

若发现版本冲突，可通过如下命令查看依赖树：

mvn dependency:tree

4. 常见问题与解决方案

1. 问题：找不到依赖或报错 404
   原因：未配置正确的仓库地址
   解决：检查是否已添加 https://repo.spring.io/snapshot 到仓库列表
2. 问题：与 spring-ai-core 冲突
   原因：不同 starter 使用了不同版本的 core 模块
   解决：显式声明 spring-ai-core 版本以统一依赖

5. 完整依赖结构图（Mermaid 流程图）

graph TD
    A[spring-ai-starter-mcp-server] --> B(spring-ai-core)
    A --> C(spring-webflux)
    A --> D(netty)
    B --> E(model-api)
    C --> F(webmvc)

6. 自动化测试验证依赖是否生效

可编写简单的集成测试来验证 MCP 服务是否启动成功：

@SpringBootTest
public class McpServerApplicationTests {

    @Autowired
    private WebService service;

    @Test
    void contextLoads() {
        assertNotNull(service);
    }
}

运行后若无报错，则说明依赖加载正常。