How santaigh/calc-api-app works
This is a calculator API with both direct arithmetic endpoints and an LLM-assisted chat workflow. Chat requests are parsed into an operation and operands, dispatched to a deterministic operation agent, calculated through an MCP tool server, then phrased as a response. The graph also preserves the direct calculator path and the four operation-specific agents. The source excerpts establish backend calls; static UI files are present, but their request wiring was not shown, so no UI-to-API edges are asserted.
Main entry points: CalcAgent.java Chat Orchestrator · CalcMcpClient.java MCP Client · CalculatorController.java Calculator API · ChatController.java Chat API
Components 22
API and Data
- Calculator API
src/main/java/com/calc/api/controller/CalculatorController.java - Calculation Request
src/main/java/com/calc/api/dto/CalculationRequest.java - Calculator Service
src/main/java/com/calc/api/service/CalculatorService.java - Chat API
src/main/java/com/calc/api/controller/ChatController.java - Chat Request
src/main/java/com/calc/api/dto/ChatRequest.java - Chat Response
src/main/java/com/calc/api/dto/ChatResponse.java - Parsed Calculation
src/main/java/com/calc/api/dto/ParsedCalculation.java - Chat Web UI
src/main/resources/static/chat.html - Chat UI Script
src/main/resources/static/js/chat.js - Calculator Web UI
src/main/resources/static/index.html - Calculator UI Script
src/main/resources/static/js/app.js
Chat Workflow
- Chat Orchestrator
src/main/java/com/calc/api/agent/CalcAgent.java - Addition Agent
src/main/java/com/calc/api/agent/AddAgent.java - Subtraction Agent
src/main/java/com/calc/api/agent/SubtractAgent.java - Multiplication Agent
src/main/java/com/calc/api/agent/MultiplyAgent.java - Division Agent
src/main/java/com/calc/api/agent/DivisionAgent.java - Operation Contract
src/main/java/com/calc/api/agent/OperationAgent.java
Calculator MCP
- MCP Client
src/main/java/com/calc/api/agent/CalcMcpClient.java - Unavailable Error
src/main/java/com/calc/api/agent/CalculatorUnavailableException.java
Other components
- Web User
- Language Model
- Calculator MCP Server
Connections 21
- Web User → Calculator API: submits calculation
src/main/java/com/calc/api/controller/CalculatorController.java - Web User → Chat API: sends message
src/main/java/com/calc/api/controller/ChatController.java - Calculator API → Calculation Request: accepts
src/main/java/com/calc/api/controller/CalculatorController.java - Calculator API → Calculator Service: calls
src/main/java/com/calc/api/controller/CalculatorController.java - Chat API → Chat Request: accepts
src/main/java/com/calc/api/controller/ChatController.java - Chat API → Chat Orchestrator: delegates to
src/main/java/com/calc/api/controller/ChatController.java - Chat Orchestrator → Parsed Calculation: parses into
src/main/java/com/calc/api/agent/CalcAgent.java - Chat Orchestrator → Language Model: prompts twice
src/main/java/com/calc/api/agent/CalcAgent.java - Chat Orchestrator → Addition Agent: dispatches to
src/main/java/com/calc/api/agent/CalcAgent.java - Chat Orchestrator → Subtraction Agent: dispatches to
src/main/java/com/calc/api/agent/CalcAgent.java - Chat Orchestrator → Multiplication Agent: dispatches to
src/main/java/com/calc/api/agent/CalcAgent.java - Chat Orchestrator → Division Agent: dispatches to
src/main/java/com/calc/api/agent/CalcAgent.java - Chat Orchestrator → Chat Response: returns
src/main/java/com/calc/api/agent/CalcAgent.java - Addition Agent → MCP Client: calls
src/main/java/com/calc/api/agent/AddAgent.java - Subtraction Agent → MCP Client: calls
src/main/java/com/calc/api/agent/SubtractAgent.java - Multiplication Agent → MCP Client: calls
src/main/java/com/calc/api/agent/MultiplyAgent.java - Division Agent → MCP Client: calls
src/main/java/com/calc/api/agent/DivisionAgent.java - MCP Client → Calculator MCP Server: calls tool
src/main/java/com/calc/api/agent/CalcMcpClient.java - MCP Client → Unavailable Error: throws on failure
src/main/java/com/calc/api/agent/CalcMcpClient.java - Chat Web UI → Chat UI Script: loads
- Calculator Web UI → Calculator UI Script: loads