awesome-spring-ai:基于 Spring 生态的生成式 AI 应用资源项目

A curated list of awesome resources, tools, tutorials, and projects for building generative AI applications using Spring AI

分支1Tags0
当前项目代码仓暂无内容

Awesome Spring AI Awesome

一份精心整理的优质资源、工具、教程和项目列表,旨在帮助开发者使用 Spring AI 构建生成式 AI 应用。本仓库致力于协助开发者在 Spring 生态系统中充分利用大型语言模型(LLMs)的强大能力。

目录

What is Spring AI?

Spring AI 是 Spring 团队的一个项目,它为构建 AI 应用提供了熟悉且一致的 Spring 风格开发者体验。它简化了将大型语言模型和其他 AI 功能集成到 Spring 应用程序中的过程,提供以下特性:

  • 跨不同 AI 提供商的一致抽象
  • 对主流 LLM 提供商的支持
  • 强大的提示工程能力
  • 内置缓存和重试机制
  • 向量化存储集成
  • 流式响应
  • 可自定义的模型参数
  • 原生 Spring Boot 集成

官方资源

文档

Spring AI 博客

学习资源

书籍

文章

在线培训

Udemy 课程

演讲与视频

办公时间与社区直播

通用播放列表

研讨会

非英语资源

文章(其他语言)

视频(其他语言)

代码与示例

综合示例集

  • Thomas Vitale 的 Spring AI 示例 - 丰富的示例集合,展示如何构建由生成式 AI 和大型语言模型(LLMs)驱动的 Java 应用程序。包括不同 AI 模型的示例、RAG 实现以及各种 Spring AI 功能。

  • Craig Walls 的 Spring AI 示例 - 全面的代码库,包含数十个示例,涵盖所有主要的 Spring AI 功能、模型集成和实现模式。由《Spring AI in Action》一书的作者创建。

  • Piotr Minkowski 的 Spring AI 展示项目 - 模块化演示项目,展示多种 Spring AI 功能,包括提示模板、聊天记忆、结构化输出、函数调用、使用 Pinecone 向量存储的 RAG 以及图像模型。通过基于配置文件的设置支持多个 AI 提供商(OpenAI、Mistral、Ollama、Azure OpenAI)。

代码示例

  • Spring AI 官方示例 - 全面的官方代码库,包含所有 Spring AI 功能的示例,包括 MCP 动态工具、提示工程模式、智能体工作流、向量存储以及各种模型集成(2025)
  • Spring AI Docker Model Runner 示例 - 展示如何将 Docker Model Runner 与 Spring AI 结合用于本地开发和测试的集成示例(2025)
  • Spring PetClinic AI - 经典的 Spring PetClinic 应用程序,通过 Spring AI 增强了聊天机器人功能。演示了与应用程序数据的自然语言交互,允许用户通过对话查询和修改宠物诊所信息。支持 OpenAI 和 Azure OpenAI 作为 LLM 提供商。在 spring.io 上的两部分博客系列中有详细介绍。
  • 航班预订助手 - 由 Spring AI 驱动的专家系统演示,模拟航班预订助手。展示如何使用 Spring AI 构建特定领域的 AI 助手。
  • Spring AI 集成千帆 - Spring AI 对千帆平台各种 AI 语言模型的支持。展示如何与千帆语言模型交互,并基于千帆模型创建多语言对话助手。
  • 使用 Spring AI 进行相似度搜索 - 简单相似度搜索的实现。演示如何使用 Kotlin 或 Java 结合 Spring-AI 生成嵌入并执行简单的相似度搜索(2025 年 3 月)
  • 具有短期和长期记忆的 Spring AI 购物代理 - 基于 Spring AI 和模型上下文协议(MCP)构建的 AI 购物助手。

用户界面客户端

  • Spring AI HTMX MCP - 使用 HTMX 为 Spring AI 应用构建现代化、交互式用户界面的示例。展示了如何利用 HTMX 的服务器端渲染能力结合 Spring AI 的模型上下文协议(Model Context Protocol),以最少的 JavaScript 创建响应式聊天界面。

  • Spring AI Vaadin - Spring AI 与 Vaadin 的集成,后者是一个用于构建现代 Web 应用的 Java Web 框架。提供了组件和示例,帮助开发者使用纯 Java 创建丰富、交互式的 AI 驱动用户界面,无需 JavaScript 或 HTML 知识。

  • DocumentGPT - 由 Sergi Almar 开发的基于 RAG 的文档查询系统,允许用户上传文档并使用 Spring AI 的向量搜索功能与之对话。具备基于 Web 的用户界面,用于文档上传和交互式查询。

  • Spring AI Playground - 一个 Web 用户界面,旨在让 Java 开发者轻松试验和集成 AI 模型。提供交互式界面,用于测试不同的提示词和模型。

  • YPipe (GitHub) - 一个基于 Java 原生、离线本地 AI 编排引擎,使用 Spring AI 和 JavaFX 构建,适用于 Linux、Windows 和 macOS。它将高性能推理引擎、专用模型和 MCP 服务器捆绑到单个零依赖可执行文件或 JBang 脚本中。这个“模型交换机”(Model Switchboard)支持具有 100% 数据主权的自主智能体工作流,桥接本地智能与企业系统。

命令行应用

  • Spring AI Chat Bot CLI - 具有检索增强生成(RAG)和对话记忆功能的命令行聊天机器人。展示了如何使用 Spring AI 构建交互式命令行应用。

  • Spring AI Powered Local CLI Chat Bot - 一个完全本地的、由 Spring AI 驱动的命令行聊天机器人,可在您的机器上完全运行,无需外部服务。非常适合离线开发或隐私敏感型应用。

扩展与分支项目

  • Spring AI Alibaba - Spring AI 的扩展,为 Java 开发者提供了一个智能体 AI 框架。增加了对阿里云通义千问(QWen)模型和灵积(Dashscope)服务的支持,以及对话记忆、RAG 支持和函数调用等附加功能。在保持与 Spring AI API 兼容性的同时,为阿里云 AI 生态系统提供了专门的功能。
  • Regulus - 适用于 Google ADK 的开源欧盟及英国合规层。运行时 ADK 插件套件,具备 PII 脱敏、双控终止开关、故障封闭数据驻留、模型风险分级以及与欧盟 AI 法案、GDPR、DORA、NIS2、英国 GDPR、FCA SYSC、PRA SS1/23 相映射的哈希链式审计信封。Spring Boot starter 通过 application.yaml 自动装配所有插件。(MIT 许可证,Maven 坐标 com.neullabs:regulus-ai-adk-plugins,ADK 1.2.0)
  • Cycles Spring AI Starter - 一个 Spring AI 增强器及自动配置组件,为 ChatClient 调用添加预算执行和运行时权限控制。在每次 LLM 调用前,会针对 Cycles 权限服务器执行预留→调用→提交/释放的生命周期;若被拒绝,在联系提供商之前就会抛出异常。多租户 LLM 成本控制,支持按主体归因。兼容 Java 21+、Spring Boot 3.5+ 和 Spring AI 1.0+。

开发工具

  • Arconia Ollama Dev Service - 一个 Spring Boot 开发服务,可自动管理 Ollama 实例,用于本地 LLM 开发。通过处理容器生命周期和配置,简化了使用本地模型的测试和开发工作。与 Spring AI 的 Ollama 支持无缝集成。
  • json-io — 具有完整 TOON 读写支持的 Java 库,针对 LLM 优化的序列化。与 JSON 相比,可减少 40-50% 的令牌数量,同时能处理复杂对象图、循环引用和泛型。

模型上下文协议(Model Context Protocol)

核心资源

  • MCP 文档 - 在 Spring AI 应用中实现模型上下文协议的官方文档。
  • MCP 客户端示例 - 展示 Spring AI 中模型上下文协议实现的综合示例,包括客户端-服务器通信、工具发现、文件系统操作、天气服务、网络搜索集成以及动态工具更新。
  • MCP 注解 - 用于实现 MCP 服务器和客户端的基于注解的编程模型。提供了一种简洁的声明式方法来处理 MCP 操作,减少样板代码。包含仅依赖 MCP Java SDK 的核心注解以及一个 Spring AI 集成模块。

Spring 项目的 MCP 服务器

  • Spring Batch MCP 服务器 - 用于内省 Spring Batch 应用的 MCP 服务,为 AI 助手提供批处理作业信息的访问权限。
  • Spring Cloud Config MCP 服务器 - Spring Cloud Config 的实验性 MCP 服务器实现,它将配置管理操作公开为 AI 工具,允许 AI 助手检索、更新和刷新应用配置,以及加密/解密敏感值。
  • Swagger MCP 桥接器 - 一个 Spring Boot 启动器,可将 SpringDoc OpenAPI 操作转换为具有验证、工作流编排和防护功能的 MCP 工具。
  • JVM 诊断 MCP - 用于获取 JVM 诊断信息的模型上下文协议服务,允许 AI 助手访问 Java 应用程序的运行时信息。
  • Maven 工具 MCP 服务器 - 为 AI 助手提供实时 Maven Central 依赖项智能,并集成了 Context7 文档。

特定领域的 MCP 实现

  • Kotlin 加密货币价格 MCP 服务器 - 一个基于 Kotlin 的 Spring AI MCP 服务器,提供来自 Binance 的实时加密货币价格信息。
  • Spring AI MCP 数据库集成示例 - 一个实用的 MCP 与 Spring AI 集成实现,包含两个服务器应用程序,通过 @Tool 注解公开数据库操作(人员和账户数据),以及一个使用 OpenAI 模型发现和使用这些工具的客户端应用程序。
  • GitHub MCP 应用 - 由 Devoxx 创始人 Stephan Janssen 基于 Spring AI 构建的 100% Java GitHub MCP 应用。
  • Druid MCP 服务器 - 一个基于 Java 的 Apache Druid 企业级 MCP 服务器,提供丰富的工具、资源和 AI 辅助提示,用于使用 spring-ai-1.1.0 Milestone 版本的新 @Mcp 注解(@McpTool)和 Oauth 管理和分析 Druid 集群。
  • AWS 示例 MCP 演示 - 展示如何将模型上下文协议与 AWS 服务结合使用的示例集合,包括 Spring AI 实现。

社区

值得关注的人

交流社区

播客

YouTube

频道

工具与性能

基准测试

贡献指南

我们始终欢迎您的贡献!请先阅读贡献指南。

项目介绍

A curated list of awesome resources, tools, tutorials, and projects for building generative AI applications using Spring AI

定制我的领域