springAi 1.0.0-M7 怎么使用MCP客户端

<think>嗯，用户想了解SpringAI1.0.0-M7中使用MCP客户端的具体方法。但用户提交的内容有些碎片化，需要从中提取关键信息。用户引用了两段资料：第一段提到M7/M8版本升级到1.0.0的配置变化，特别是SSE连接的设置方式；第二段提到SpringAIMCP的基本概念和官网文档。不过用户最后的明确需求是“M7版本使用MCP客户端指南”。用户可能是开发者，正在尝试集成大模型能力到Spring应用中，但遇到了版本升级的适配问题。从ta引用配置片段的行为看，应该卡在具体配置实施环节。需要特别注意ta提到的版本是较老的M7（里程碑版），而当前官方已迭代到稳定版1.0.0，这可能导致部分文档不匹配。专业层面需要分三层处理：首先是库引入方式，MCP功能在spring-ai-mcp模块中；其次是配置范式变化——从M7到正式版，配置前缀从spring.ai.mcp调整为了spring.ai.model-context；最后是实战要点，特别是SSE流式接口的端点映射问题。用户引用的示例里server1.url和sse-endpoint组合成完整URL的写法正是关键。需要警告用户关于M7版本的兼容性风险，但不必直接劝升级，而是标注配置差异点。比如正式版废弃了connections.server1.url的分组写法，改用统一模型名称映射。响应时要准备三块核心内容：依赖管理（pom.xml示例）、新旧配置对比表（突出M7特有写法）、以及一个可运行的Controller调用示例。用户可能没有注意到SpringAI的文档版本切换功能，考虑在回答中提示ta查看M7版本文档的具体路径。关于SSE认证问题（引用示例中出现的ak参数），需要主动说明参数传递机制，虽然用户没直接问但很可能遇到。</think> 在 Spring AI 1.0.0-M7 中使用 MCP（Model Context Protocol）客户端，主要涉及配置和客户端调用。以下是关键步骤和注意事项（**请注意 M7 是里程碑版本，配置方式可能与后续稳定版不同**）： --- ### **1. 添加依赖** 确保项目中包含 `spring-ai-mcp` 依赖： ```xml <dependency> <groupId>org.springframework.ai</groupId> <artifactId>spring-ai-mcp</artifactId> <version>1.0.0-M7</version> <!-- 明确指定 M7 版本 --> </dependency> ``` --- ### **2. 配置 MCP 服务端连接** 在 `application.properties` 或 `application.yml` 中配置 SSE（Server-Sent Events）连接信息，格式需严格遵循： ```properties # 基本连接配置（对应引用[1]的 M7 格式） spring.ai.mcp.client.sse.connections.server1.url=http://localhost:8080 spring.ai.mcp.client.sse.connections.server1.sse-endpoint=/sse # 可选：配置多服务器或认证参数 spring.ai.mcp.client.sse.connections.server2.url=https://mcp.example.com spring.ai.mcp.client.sse.connections.server2.sse-endpoint=/sse?ak=your-api-key ``` ⚠️ **重要说明** - `url` 定义服务端基础地址，`sse-endpoint` 定义 SSE 路径，二者拼接形成完整 URL（如 `http://localhost:8080/sse`）[^1]。 - 配置键为 `spring.ai.mcp.client.sse.connections.{server-name}.*`，其中 `{server-name}` 为自定义标识（如 `server1`）。 --- ### **3. 注入 MCP 客户端并调用** 通过 `AIClient` 接口操作 MCP 服务： ```java import org.springframework.ai.client.AIClient; import org.springframework.ai.model.ModelContext; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Component; @Component public class McpService { private final AIClient aiClient; @Autowired public McpService(AIClient aiClient) { this.aiClient = aiClient; } public String generateResponse(String prompt) { // 构建请求（ModelContext 封装 MCP 协议数据） ModelContext context = ModelContext.of("server1") // 使用配置的 server1 .withPrompt(prompt) .withTemperature(0.8); // 发送请求并获取响应 return aiClient.generate(context).getText(); } } ``` --- ### **关键注意事项（M7 版本）** 1. **配置前缀** 必须使用 `spring.ai.mcp.client.sse.connections.*`（稳定版 1.0.0 后可能调整）[^1]。 2. **SSE 端点定义** `sse-endpoint` 需包含路径和查询参数（如认证 `ak`），参考引用[1]中的 `/sse?ak=123456789` 格式[^1]。 3. **多服务切换** 在代码中通过 `ModelContext.of("server-name")` 指定使用的配置（如 `server1` 或 `server2`）。 4. **协议兼容性** MCP 要求服务端实现 Server-Sent Events 流式传输，确保后端支持 MCP 规范（参考[官网文档](https://spring.io/projects/spring-ai)）[^2]。 --- ### **常见问题排查** - **连接失败**：检查 `url + sse-endpoint` 拼接后的完整 URL 是否可访问。 - **认证错误**：在 `sse-endpoint` 中正确传递 API Key（如 `?ak=your-key`）。 - **版本冲突**：若升级到 1.0.0+，需迁移至新配置格式（如 `spring.ai.model-context.*`）。 ---