# java-ai

**Repository Path**: ly8848/java-ai

## Basic Information

- **Project Name**: java-ai
- **Description**: 用于初学springAI相关的demo
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-05
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# java-ai  Spring Boot 集成示例

## 项目概述
本项目是一个综合性的AI集成示例，包含了多个模块，分别基于LangChain4j和Spring-ai-alibaba框架，实现了丰富的AI功能。

### LangChain4j模块功能：
- 🤖 多模型支持（阿里通义、DeepSeek、Ollama等）
- 📚 RAG（检索增强生成）实现
- 🛠️ 工具函数调用
- 💬 流式对话接口（SSE）
- 🧠 持久化聊天记忆
- 🗄️ 向量存储（DuckDB）

### Spring-ai-alibaba模块功能：
- 🤖 简单对话实现
- 🔄 基于MCP（Model Context Protocol）的流式调用服务端
- 📡 基于MCP的标准输入输出服务端与客户端
- 💬 聊天记忆功能

## 项目结构

```
java-ai/
├── langchain4j-springBoot-demo/     # 基于LangChain4j的AI功能模块
├── spring-ai-alibaba-demo/          # 基于Spring-ai-alibaba的基础功能模块
├── spring-ai-alibaba-mcp-sse-server/ # 基于MCP的SSE服务端
├── spring-ai-alibaba-mcp-stdio-client/ # 基于MCP的stdio客户端
├── spring-ai-alibaba-mcp-stdio-server/ # 基于MCP的stdio服务端
└── README.md
```

## 技术栈

### LangChain4j模块技术栈
- **框架**: Spring Boot 3.1.5
- **AI核心**: LangChain4j 1.0.0-beta2
- **向量存储**: DuckDB
- **模型服务**:
  - 阿里云 DashScope
  - DeepSeek
  - Ollama（本地部署）
- **持久化**: MapDB

### Spring-ai-alibaba模块技术栈
- **框架**: Spring Boot 3.4.3
- **AI核心**: spring-ai-alibaba 1.0.0-M6.1
- **模型服务**: 阿里云 DashScope
- **协议支持**: Model Context Protocol (MCP)

## 快速开始

### 环境要求
- JDK 17+
- Maven 3.8+
- Ollama（用于langchain4j模块，如需使用本地模型）

### 启动步骤
1. 克隆仓库
```bash
git clone https://github.com/sunlight-hua/langchain4j-demo.git
```

2. 各模块配置说明：
   - **langchain4j-springBoot-demo**: 需要配置Ollama服务或阿里云DashScope API密钥
   - **spring-ai-alibaba-demo**: 需要配置阿里云DashScope API密钥
   - **MCP相关模块**: 需要配置阿里云API密钥，用于MCP服务

3. 参照每个模块的README.md进行具体配置和启动

## 模块说明

### langchain4j-springBoot-demo
提供完整的AI功能实现，包括对话、RAG、工具调用等。默认端口8888。

### spring-ai-alibaba-demo
基于Spring AI Alibaba的简单对话实现。默认端口8084。

### spring-ai-alibaba-mcp-sse-server
基于MCP协议的SSE服务端实现。默认端口8085。

### spring-ai-alibaba-mcp-stdio-client
基于MCP协议的stdio客户端实现。默认端口8089。

### spring-ai-alibaba-mcp-stdio-server
基于MCP协议的stdio服务端实现，无Web应用类型。

## API端点参考

### langchain4j-springBoot-demo
- `GET /ai/simple/doAsk` - 基础AI问答
- `GET /ai/simple/doAsk2` - 带系统提示词的AI问答
- `GET /ai/simple/doAskSSE` - 流式AI问答（SSE）
- `GET /ai/memoryChart/doAsk` - 记忆化AI问答
- `GET /ai/memoryChart/doAskWithMemory2` - 带上下文记忆的AI问答
- `GET /ai/rag/doAsk` - RAG（检索增强生成）问答

### spring-ai-alibaba-demo
- `GET /hello` - 健康检查
- `POST /client/simple/chat` - 简单聊天
- `POST /client/stream/chat` - 流式聊天
- `POST /chat-memory/in-memory` - 带记忆的聊天

更多详细信息请参考各个模块的README.md文件。