How yar83men/spring-boot-ai-mcp works
This is a Spring AI application split into an HTTP-facing client and an MCP tool server. The main workflow is a user request through client controllers to AI services and back; other documented capabilities include RAG ingestion/retrieval, conversational memory, image understanding, web search, weather, exchange rates, file operations and Gmail subjects. The graph retains these feature branches, but several service implementations and routes were not sampled, so their internal call links are left out rather than inferred.
Main entry points: ChatController.java Chat API · McpServerConfiguration.java Tool registration · DocumentService.java RAG services · DocumentController.java Document upload
Components 26
AI client
- Chat API
spring_ai_mcp_client/src/main/java/com/openai/client/controller/ChatController.java - Chat services
spring_ai_mcp_client/src/main/java/com/openai/client/service/impl/ChatAIServiceImpl.java - Chat configuration
spring_ai_mcp_client/src/main/java/com/openai/client/configuration/ChatClientCustomConfiguration.java - Chat memory
spring_ai_mcp_client/src/main/java/com/openai/client/service/ChatMemoryService.java - Document upload
spring_ai_mcp_client/src/main/java/com/openai/client/controller/DocumentController.java - RAG services
spring_ai_mcp_client/src/main/java/com/openai/client/service/DocumentService.java - Image understanding
spring_ai_mcp_client/src/main/java/com/openai/client/service/impl/ImageAIServiceImpl.java - Image API
spring_ai_mcp_client/src/main/java/com/openai/client/controller/ImageController.java - Weather API
spring_ai_mcp_client/src/main/java/com/openai/client/controller/WeatherController.java - Weather service
spring_ai_mcp_client/src/main/java/com/openai/client/service/impl/WeatherServiceImpl.java - Web search API
spring_ai_mcp_client/src/main/java/com/openai/client/service/impl/WebSearchAiServiceImpl.java - File operations
spring_ai_mcp_client/src/main/java/com/openai/client/controller/FileCreationAIController.java - File service
spring_ai_mcp_client/src/main/java/com/openai/client/service/FileCreatingAIService.java - Exchange API
spring_ai_mcp_client/src/main/java/com/openai/client/controller/ExchangeController.java - Web search route
spring_ai_mcp_client/src/main/java/com/openai/client/controller/WebSearchAiController.java
MCP tools
- Tool registration
spring_ai_mcp_server/src/main/java/com/openai/server/configuration/McpServerConfiguration.java - Weather tool
spring_ai_mcp_server/src/main/java/com/openai/server/service/WeatherApiToolService.java - Exchange tool
spring_ai_mcp_server/src/main/java/com/openai/server/service/ExchangeCbrToolService.java - Gmail subjects
spring_ai_mcp_server/src/main/java/com/openai/server/service/GMailService.java
External systems
- OpenAI
- PGVector
- Weather provider
- Central bank
- Gmail
- Filesystem MCP
Other components
- User
Connections 26
- User → Chat API: submits request
spring_ai_mcp_client/src/main/java/com/openai/client/controller/ChatController.java - Chat API → Chat services: calls chat
spring_ai_mcp_client/src/main/java/com/openai/client/controller/ChatController.java - Chat configuration → OpenAI: configures client
spring_ai_mcp_client/src/main/java/com/openai/client/configuration/ChatClientCustomConfiguration.java - Chat API → Chat memory: calls memory chat
spring_ai_mcp_client/src/main/java/com/openai/client/controller/ChatController.java - User → Document upload: uploads document
spring_ai_mcp_client/src/main/java/com/openai/client/controller/DocumentController.java - Document upload → RAG services: parses and saves
spring_ai_mcp_client/src/main/java/com/openai/client/controller/DocumentController.java - RAG services → PGVector: stores documents
- Chat API → RAG services: retrieves context
spring_ai_mcp_client/src/main/java/com/openai/client/controller/ChatController.java - User → Image API: submits image
spring_ai_mcp_client/src/main/java/com/openai/client/controller/ImageController.java - Image API → Image understanding: calls analysis
spring_ai_mcp_client/src/main/java/com/openai/client/controller/ImageController.java - User → Weather API: requests forecast
spring_ai_mcp_client/src/main/java/com/openai/client/controller/WeatherController.java - Weather API → Weather service: calls weather
spring_ai_mcp_client/src/main/java/com/openai/client/controller/WeatherController.java - Weather service → OpenAI: formats response
- User → Web search route: requests search
- Web search route → Web search API: calls search
- Web search API → OpenAI: runs prompt
spring_ai_mcp_client/src/main/java/com/openai/client/service/impl/WebSearchAiServiceImpl.java - Tool registration → Weather tool: registers tool
spring_ai_mcp_server/src/main/java/com/openai/server/configuration/McpServerConfiguration.java - Tool registration → Exchange tool: registers tool
spring_ai_mcp_server/src/main/java/com/openai/server/configuration/McpServerConfiguration.java - Tool registration → Gmail subjects: registers tool
spring_ai_mcp_server/src/main/java/com/openai/server/configuration/McpServerConfiguration.java - Weather tool → Weather provider: fetches forecast
spring_ai_mcp_server/src/main/java/com/openai/server/service/WeatherApiToolService.java - Exchange tool → Central bank: fetches rates
spring_ai_mcp_server/src/main/java/com/openai/server/service/ExchangeCbrToolService.java - Gmail subjects → Gmail: reads subjects
spring_ai_mcp_server/src/main/java/com/openai/server/service/GMailService.java - User → File operations: requests file task
- File operations → File service: calls file service
spring_ai_mcp_client/src/main/java/com/openai/client/controller/FileCreationAIController.java - File service → Filesystem MCP: uses MCP server
- User → Exchange API: requests conversion