SuperAPI AI 工具集

spring-ai-mcp-server-patterns

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:在 Spring Boot 项目中用 Spring AI 构建 MCP 服务端,向 AI 模型暴露可调用工具与提示模板,支持函数调用、资源端点与传输配置。

主要能力:通过 @EnableMcpServer 启用自动配置;用 @Tool(description) 声明 AI 可调用方法,@ToolParam 描述参数;用 @PromptTemplate(name) 与 @PromptParam 声明可复用提示模板;支持 stdio(本地进程/Claude Desktop,默认)、http、sse 三种传输,可配置端口与路径;提供 ToolFilter 与 @PreAuthorize 做工具级安全控制。

使用方式:引入依赖 org.springframework.ai:spring-ai-mcp-server 与 spring-ai-starter-model-openai(示例版本 1.0.0),在 application.properties 配置模型密钥与 spring.ai.mcp.enabled=true、spring.ai.mcp.transport.type=stdio 等;在 @Component 中编写 @Tool 方法;用 @SpringBootTest 配合 @MockBean 做单元测试。

适用场景:需要为 AI 提供自定义工具、数据库只读查询、REST API 集成、文件系统工具或提示模板服务的 Spring Boot 应用。

限制与注意:AI 生成的参数不可信,必须校验与清洗;SQL 仅用参数化查询,文件路径需规范化防目录穿越;工具错误信息会暴露给模型,需脱敏;响应应精简以免超出上下文窗口;所有外部调用需设超时,注意线程安全与限流;Spring AI 迭代较快,生产环境应固定版本。详细模式见 references 下的实现、测试、示例与迁移文档。