Spring AI 示例项目

Spring AI 示例项目

演示 Spring AI 工具的实现模式和最佳实践，包含 MCP 服务器和客户端模块。

GitHub
Created Bylucasdengcnlucasdengcn

快速入门

项目概述

该项目展示如何使用 Spring AI 工具的最佳实践，包含两个主要模块：

  • mcp-server：实现支持 WebFlux 和 WebMvc SSE 的 MCP 服务器。
  • proposal-agent：实现用于生成 AI 提案的 MCP 客户端。

项目结构

.
├── mcp-server/       # MCP 服务器实现
│   ├── src/          # 服务器源代码
│   └── README.md     # 服务器文档
├── proposal-agent/   # MCP 客户端实现
│   ├── src/          # 客户端源代码
│   └── README.md     # 客户端文档
└── src/              # 公共源代码

核心功能

  1. 方法作为工具：通过 @Tool 注解将方法注册为工具。
  2. 自定义结果转换器：使用 resultConverter 控制工具结果格式。
  3. 工具上下文：通过 ToolContext 参数访问上下文信息。
  4. 参数描述：使用 @ToolParam 注解为工具参数添加描述。

配置

  • 集成 Ollama AI 模型
  • 使用 PGVector 存储向量
  • 内置 H2 数据库
  • 支持 CORS 和 SSE 实时更新

运行项目

  1. 克隆仓库：git clone https://github.com/lucasdengcn/spring-ai-example.git
  2. 启动 Spring Boot 应用程序。
  3. 访问相关模块的功能接口。