# sivaprasadreddy/sivalabs-spring-ai-course architecture

> Architecture diagram of the GitHub repository sivaprasadreddy/sivalabs-spring-ai-course, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sivaprasadreddy/sivalabs-spring-ai-course
- Repository: https://github.com/sivaprasadreddy/sivalabs-spring-ai-course

## Overview

This repository is a Spring AI course made up of independent example applications, not one deployed end-to-end product. The course progresses from provider-backed chat through prompt templates, structured output, memory, RAG, and tool calling, then demonstrates MCP servers and clients. The sampled MCP client accepts a question, calls a chat model with registered tool callbacks, formats the answer, and returns HTML; the server exposes video-search tools backed by a repository. Earlier lesson internals are not sampled, so their feature nodes reflect README coverage rather than inspected implementation.

Main entry points: [`12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/VideoController.java`](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/VideoController.java) (Question endpoint), [`13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/VideoController.java`](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/VideoController.java) (Question endpoint), [`10-sivalabs-mcp-server-stdio/src/main/java/com/sivalabs/mcpserver/VideoTools.java`](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/10-sivalabs-mcp-server-stdio/src/main/java/com/sivalabs/mcpserver/VideoTools.java) (Video tools), [`11-sivalabs-mcp-server-webflux/src/main/java/com/sivalabs/mcpserver/VideoTools.java`](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/11-sivalabs-mcp-server-webflux/src/main/java/com/sivalabs/mcpserver/VideoTools.java) (Video tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_chat["Chat Examples"]
  node_openai["OpenAI chat"]
  node_compat["Compatible models"]
  node_ollama["Ollama chat"]
  node_anthropic["Anthropic chat"]
end

subgraph group_ai["AI Capabilities"]
  node_templates["Prompt templates"]
  node_structured["Structured output"]
  node_memory["Chat memory"]
  node_rag["RAG vector store"]
  node_toolcalling["Tool calling"]
end

subgraph group_mcpserver["MCP Servers"]
  node_stdio_tools["Video tools<br/>[VideoTools.java]"]
  node_stdio_repo[("Video repository")]
  node_webflux_tools["Video tools<br/>[VideoTools.java]"]
  node_webflux_repo[("Video repository")]
end

subgraph group_mcpclient["MCP Clients"]
  node_stdio_client["Question endpoint"]
  node_stdio_markdown["Markdown renderer"]
  node_webflux_client["Question endpoint"]
  node_webflux_markdown["Markdown renderer"]
end

node_learner(("Course user"))
node_model{{"Chat model"}}
node_mcp_host(("MCP host"))

node_learner -.->|"submits prompt"| node_openai
node_learner -.->|"submits prompt"| node_compat
node_learner -.->|"submits prompt"| node_ollama
node_learner -.->|"submits prompt"| node_anthropic
node_learner -.->|"submits prompt"| node_templates
node_learner -.->|"submits prompt"| node_structured
node_learner -.->|"submits prompt"| node_memory
node_learner -.->|"submits prompt"| node_rag
node_learner -.->|"submits prompt"| node_toolcalling
node_learner -->|"posts question"| node_stdio_client
node_stdio_client -->|"calls chat"| node_model
node_stdio_client -->|"registers callbacks"| node_mcp_host
node_stdio_client -->|"renders HTML"| node_stdio_markdown
node_learner -->|"posts question"| node_webflux_client
node_webflux_client -->|"calls chat"| node_model
node_webflux_client -->|"registers callbacks"| node_mcp_host
node_webflux_client -->|"renders HTML"| node_webflux_markdown
node_mcp_host -.->|"invokes tools"| node_stdio_tools
node_mcp_host -.->|"invokes tools"| node_webflux_tools
node_stdio_tools -->|"queries videos"| node_stdio_repo
node_webflux_tools -->|"queries videos"| node_webflux_repo

click node_openai "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/01-chat-openai/src/main/java/com/sivalabs/demo/ChatController.java"
click node_compat "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/02-openai-compat-chat/src/main/java/com/sivalabs/demo/ChatController.java"
click node_ollama "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/03-chat-ollama/src/main/java/com/sivalabs/demo/ChatController.java"
click node_anthropic "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/04-chat-anthropic/src/main/java/com/sivalabs/demo/ChatController.java"
click node_templates "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/05-prompt-templates/src/main/java/com/sivalabs/demo/ChatController.java"
click node_structured "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/06-structured-output/src/main/java/com/sivalabs/demo/ChatController.java"
click node_memory "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/07-chat-memory/src/main/java/com/sivalabs/demo/ChatController.java"
click node_rag "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/08-rag-vector-store/src/main/java/com/sivalabs/demo/ChatController.java"
click node_toolcalling "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/09-tool-calling/src/main/java/com/sivalabs/demo/ChatController.java"
click node_stdio_tools "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/10-sivalabs-mcp-server-stdio/src/main/java/com/sivalabs/mcpserver/VideoTools.java"
click node_stdio_repo "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/10-sivalabs-mcp-server-stdio/src/main/java/com/sivalabs/mcpserver/VideoRepository.java"
click node_webflux_tools "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/11-sivalabs-mcp-server-webflux/src/main/java/com/sivalabs/mcpserver/VideoTools.java"
click node_webflux_repo "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/11-sivalabs-mcp-server-webflux/src/main/java/com/sivalabs/mcpserver/VideoRepository.java"
click node_stdio_client "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/VideoController.java"
click node_stdio_markdown "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/MarkdownHelper.java"
click node_webflux_client "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/VideoController.java"
click node_webflux_markdown "https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/MarkdownHelper.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_openai,node_compat,node_ollama,node_anthropic,node_learner toneBlue
class node_templates,node_structured,node_memory,node_rag,node_toolcalling toneAmber
class node_stdio_tools,node_stdio_repo,node_webflux_tools,node_webflux_repo toneMint
class node_stdio_client,node_stdio_markdown,node_webflux_client,node_webflux_markdown toneRose
class node_model,node_mcp_host toneIndigo
```

## Components

### Chat Examples

- [OpenAI chat](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/01-chat-openai/src/main/java/com/sivalabs/demo/ChatController.java): `01-chat-openai/src/main/java/com/sivalabs/demo/ChatController.java`
- [Compatible models](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/02-openai-compat-chat/src/main/java/com/sivalabs/demo/ChatController.java): `02-openai-compat-chat/src/main/java/com/sivalabs/demo/ChatController.java`
- [Ollama chat](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/03-chat-ollama/src/main/java/com/sivalabs/demo/ChatController.java): `03-chat-ollama/src/main/java/com/sivalabs/demo/ChatController.java`
- [Anthropic chat](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/04-chat-anthropic/src/main/java/com/sivalabs/demo/ChatController.java): `04-chat-anthropic/src/main/java/com/sivalabs/demo/ChatController.java`

### AI Capabilities

- [Prompt templates](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/05-prompt-templates/src/main/java/com/sivalabs/demo/ChatController.java): `05-prompt-templates/src/main/java/com/sivalabs/demo/ChatController.java`
- [Structured output](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/06-structured-output/src/main/java/com/sivalabs/demo/ChatController.java): `06-structured-output/src/main/java/com/sivalabs/demo/ChatController.java`
- [Chat memory](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/07-chat-memory/src/main/java/com/sivalabs/demo/ChatController.java): `07-chat-memory/src/main/java/com/sivalabs/demo/ChatController.java`
- [RAG vector store](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/08-rag-vector-store/src/main/java/com/sivalabs/demo/ChatController.java): `08-rag-vector-store/src/main/java/com/sivalabs/demo/ChatController.java`
- [Tool calling](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/09-tool-calling/src/main/java/com/sivalabs/demo/ChatController.java): `09-tool-calling/src/main/java/com/sivalabs/demo/ChatController.java`

### MCP Servers

- [Video tools](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/10-sivalabs-mcp-server-stdio/src/main/java/com/sivalabs/mcpserver/VideoTools.java): `10-sivalabs-mcp-server-stdio/src/main/java/com/sivalabs/mcpserver/VideoTools.java`
- [Video repository](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/10-sivalabs-mcp-server-stdio/src/main/java/com/sivalabs/mcpserver/VideoRepository.java): `10-sivalabs-mcp-server-stdio/src/main/java/com/sivalabs/mcpserver/VideoRepository.java`
- [Video tools](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/11-sivalabs-mcp-server-webflux/src/main/java/com/sivalabs/mcpserver/VideoTools.java): `11-sivalabs-mcp-server-webflux/src/main/java/com/sivalabs/mcpserver/VideoTools.java`
- [Video repository](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/11-sivalabs-mcp-server-webflux/src/main/java/com/sivalabs/mcpserver/VideoRepository.java): `11-sivalabs-mcp-server-webflux/src/main/java/com/sivalabs/mcpserver/VideoRepository.java`

### MCP Clients

- [Question endpoint](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/VideoController.java): `12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/VideoController.java`
- [Markdown renderer](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/MarkdownHelper.java): `12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/MarkdownHelper.java`
- [Question endpoint](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/VideoController.java): `13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/VideoController.java`
- [Markdown renderer](https://github.com/sivaprasadreddy/sivalabs-spring-ai-course/blob/main/13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/MarkdownHelper.java): `13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/MarkdownHelper.java`

### Other components

- **Course user**
- **Chat model**
- **MCP host**

## Connections

- Course user → OpenAI chat: submits prompt (evidence: `README.md`)
- Course user → Compatible models: submits prompt (evidence: `README.md`)
- Course user → Ollama chat: submits prompt (evidence: `README.md`)
- Course user → Anthropic chat: submits prompt (evidence: `README.md`)
- Course user → Prompt templates: submits prompt (evidence: `README.md`)
- Course user → Structured output: submits prompt (evidence: `README.md`)
- Course user → Chat memory: submits prompt (evidence: `README.md`)
- Course user → RAG vector store: submits prompt (evidence: `README.md`)
- Course user → Tool calling: submits prompt (evidence: `README.md`)
- Course user → Question endpoint: posts question (evidence: `12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/VideoController.java`)
- Question endpoint → Chat model: calls chat (evidence: `12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/VideoController.java`)
- Question endpoint → MCP host: registers callbacks (evidence: `12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/VideoController.java`)
- Question endpoint → Markdown renderer: renders HTML (evidence: `12-sivalabs-mcp-client-stdio/src/main/java/com/sivalabs/mcpclient/VideoController.java`)
- Course user → Question endpoint: posts question (evidence: `13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/VideoController.java`)
- Question endpoint → Chat model: calls chat (evidence: `13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/VideoController.java`)
- Question endpoint → MCP host: registers callbacks (evidence: `13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/VideoController.java`)
- Question endpoint → Markdown renderer: renders HTML (evidence: `13-sivalabs-mcp-client-webflux/src/main/java/com/sivalabs/mcpclient/VideoController.java`)
- MCP host → Video tools: invokes tools
- MCP host → Video tools: invokes tools
- Video tools → Video repository: queries videos (evidence: `10-sivalabs-mcp-server-stdio/src/main/java/com/sivalabs/mcpserver/VideoTools.java`)
- Video tools → Video repository: queries videos (evidence: `11-sivalabs-mcp-server-webflux/src/main/java/com/sivalabs/mcpserver/VideoTools.java`)
