mcpField
S
spring-ai-alibaba-examples

spring-ai-alibaba-examples

本地服务
github.com/springaialibaba开发工具2.9k17 周前更新
代码仓库

关于 spring-ai-alibaba-examples

这是 Spring AI 和 Spring AI Alibaba 的示例模块集合，供开发者学习如何用这些框架构建 AI 应用。内容涵盖基础聊天、MCP、RAG、图像生成和工具调用。

主要功能

  1. 01涵盖从基础到进阶的用法示例
  2. 02聊天与图像生成演示
  3. 03MCP 与 RAG 示例
  4. 04工具调用示例
  5. 05提供快速启动命令和配置参考

适用场景

  1. 01探索 Spring AI 聊天集成
  2. 02运行图像生成示例
  3. 03学习 MCP 或 RAG 演示
  4. 04了解工具调用模式

MCP 相关

包含 MCP 演示模块，供客户端探索 MCP 用法；README 未说明其向 MCP 客户端公开的内容。

#spring-ai#ai-examples#spring-ai-alibaba

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Spring AI Alibaba 示例

Spring AI Alibaba 仓库：https://github.com/alibaba/spring-ai-alibaba

Spring AI Alibaba 网站： https://java2ai.com

Spring AI Alibaba 网站仓库：https://github.com/springaialibaba/spring-ai-alibaba-website

English | 中文

介绍

此仓库中包含许多示例模块项目，介绍 Spring AI 和 Spring AI Alibaba 从基础到高级的各种用法，以及 AI 项目的最佳实践。

如需更详细的介绍，请参阅各个子项目中的 README.md 和 Spring AI Alibaba 官网。

参与建设

欢迎以任何形式贡献代码。

快速入门矩阵（社区贡献）

模块用途命令所需服务环境变量环境变量模板入口
spring-ai-alibaba-helloworld基础聊天和顾问示例mvn -pl spring-ai-alibaba-helloworld spring-boot:run无AI_DASHSCOPE_API_KEY—README
spring-ai-alibaba-chat-example/dashscope-chatDashScope 聊天基础示例mvn -pl spring-ai-alibaba-chat-example/dashscope-chat spring-boot:run无AI_DASHSCOPE_API_KEY—README
spring-ai-alibaba-image-example/dashscope-imageDashScope 图片生成mvn -pl spring-ai-alibaba-image-example/dashscope-image spring-boot:run无AI_DASHSCOPE_API_KEY—README
spring-ai-alibaba-mcp-exampleMCP 演示mvn -pl spring-ai-alibaba-mcp-example spring-boot:run无／本地 mcp 工具模型 API 密钥.env.exampleREADME
spring-ai-alibaba-rag-exampleRAG 演示mvn -pl spring-ai-alibaba-rag-example spring-boot:run向量数据库（可通过配置文件选择是否使用）模型 API 密钥、嵌入模型.env.exampleREADME
spring-ai-alibaba-tool-calling-example工具调用mvn -pl spring-ai-alibaba-tool-calling-example spring-boot:run无模型 API 密钥、地图 API 密钥.env.exampleREADME

常用配置键速查

配置键常见模块说明
AI_DASHSCOPE_API_KEYspring-ai-alibaba-helloworld、DashScope 聊天／图片、工具调用、评估以及许多 graph/rag 示例DashScope 兼容模型最常用的 API Key
OPENAI_API_KEYspring-ai-alibaba-chat-example/openai-chat、spring-ai-alibaba-chat-example/vllm-chatOpenAI 兼容接口示例常用
AI_OPENAI_API_KEYspring-ai-alibaba-image-example/openai-imageOpenAI 图片生成示例使用
AI_DEEPSEEK_API_KEYspring-ai-alibaba-chat-example/deepseek-chat、spring-ai-alibaba-mem0-exampleDeepSeek 相关示例使用
MINIMAX_API_KEYspring-ai-alibaba-chat-example/minimax-chatMiniMax 模型示例使用
ZHIPUAI_API_KEYspring-ai-alibaba-chat-example/zhipuai-chat智谱模型示例使用
BAIDU_MAP_API_KEYspring-ai-alibaba-tool-calling-example地图工具调用示例需要

常见启动问题／故障排除

  • AI_DASHSCOPE_API_KEY 未设置／缺少 AI_DASHSCOPE_API_KEY：先确认环境变量已在当前 shell 或 IDE 中生效，然后重新启动示例。
  • 端口被占用／端口已在使用：检查对应模块 application.yml 中的 server.port，释放端口或修改端口后重试。
  • 本地依赖未启动／所需的本地服务未运行：RAG、MCP、向量数据库或 Docker 相关示例通常需要先启动相应的中间件或容器。
  • 模块中暂时没有 .env.example／模块中尚无 .env.example：优先查看该模块 README 和 src/main/resources/application.yml，确认实际的变量名和依赖服务。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。