69_Spring AI 干货笔记之 MCP 服务器 Boot Starter

一、引言

模型上下文协议 (MCP) 服务器 是通过标准化协议接口向 AI 应用程序公开特定功能的程序。每个服务器都提供针对特定领域的功能。

Spring AI MCP 服务器 Boot Starter 为在 Spring Boot 应用程序中设置 MCP 服务器 提供了自动配置。它们使 MCP 服务器能力与 Spring Boot 的自动配置系统能够无缝集成。

MCP 服务器 Boot Starter 提供：

• MCP 服务器组件的自动配置，包括工具、资源和提示

• 支持不同的 MCP 协议版本，包括 STDIO、SSE、Streamable-HTTP 和无状态服务器

• 支持同步和异步操作模式

• 多种传输层选项

• 灵活的工具、资源和提示规范

• 更改通知功能

• 基于注解的服务器开发，具有自动 Bean 扫描和注册

二、MCP 服务器 Boot Starter

MCP 服务器支持多种协议和传输机制。使用专用的 starter 和正确的 spring.ai.mcp.server.protocol 属性来配置您的服务器：

2.1 STDIO

2.2 WebMVC

2.3 WebMVC (Reactive)

三、服务器能力

根据服务器和传输类型，MCP 服务器可以支持各种能力，例如：

• 工具 – 允许服务器公开可由语言模型调用的工具

• 资源 – 为服务器向客户端公开资源提供标准化方式

• 提示 – 为服务器向客户端公开提示模板提供标准化方式

• 工具/补全 – 为服务器提供提示和资源 URI 的参数自动补全建议提供标准化方式

• 工具/日志记录 – 为服务器向客户端发送结构化日志消息提供标准化方式

• 工具/进度 – 通过通知消息对长时间运行的操作进行可选的进度跟踪

• 工具/Ping – 服务器报告其状态的可选健康检查机制

所有能力默认启用。禁用某个能力将阻止服务器向客户端注册和公开相应的功能。

四、服务器协议

MCP 提供几种协议类型，包括：

• STDIO – 进程内协议（例如，服务器在主机应用程序内运行）。通信通过标准输入和标准输出进行。要启用 STDIO，请设置 spring.ai.mcp.server.stdio=true。

• SSE – 用于实时更新的服务器发送事件协议。服务器作为独立的进程运行，可以