How santaigh/mcpclient works
This is a Spring-based calculator chat client: a user submits arithmetic in the browser, the API hands the message to an agent, and the agent lets the language model choose among tools supplied by an MCP calculator server. The response includes both the model’s reply and a trace of tool calls for display. The graph includes the request, response, and tool-call records as a useful internal data layer. MCP and model connections are shown only where supported; provider configuration details were not sampled.
Main entry points: McpCalcAgent.java MCP calculator agent · chat.js Chat interaction · ChatController.java Chat endpoint · ChatResponse.java Chat response
Components 13
Browser chat
- Chat page
src/main/resources/static/chat.html - Chat interaction
src/main/resources/static/js/chat.js
Chat API
- Chat endpoint
src/main/java/com/calc/mcpclient/controller/ChatController.java
Agent and tools
- MCP calculator agent
src/main/java/com/calc/mcpclient/agent/McpCalcAgent.java - Chat client setup
src/main/java/com/calc/mcpclient/agent/ChatClientConfig.java - Tool call recorder
src/main/java/com/calc/mcpclient/agent/RecordingToolCallback.java - Unavailable error
src/main/java/com/calc/mcpclient/agent/CalculatorUnavailableException.java
Chat records
- Chat request
src/main/java/com/calc/mcpclient/dto/ChatRequest.java - Chat response
src/main/java/com/calc/mcpclient/dto/ChatResponse.java - Tool call record
src/main/java/com/calc/mcpclient/dto/ToolCall.java
Other components
- User
- MCP calculator server
- Anthropic model
Connections 17
- User → Chat page: uses
- Chat page → Chat interaction: loads
- Chat interaction → Chat endpoint: posts message
src/main/resources/static/js/chat.js - Chat endpoint → Chat request: accepts
src/main/java/com/calc/mcpclient/controller/ChatController.java - Chat endpoint → MCP calculator agent: handles message
src/main/java/com/calc/mcpclient/controller/ChatController.java - MCP calculator agent → Chat response: creates
src/main/java/com/calc/mcpclient/agent/McpCalcAgent.java - Chat endpoint → Chat response: returns
src/main/java/com/calc/mcpclient/controller/ChatController.java - Chat interaction → Chat response: renders reply
src/main/resources/static/js/chat.js - MCP calculator agent → Chat client setup: uses client
- MCP calculator agent → MCP calculator server: lists tools
src/main/java/com/calc/mcpclient/agent/McpCalcAgent.java - MCP calculator agent → Tool call recorder: wraps tools
src/main/java/com/calc/mcpclient/agent/McpCalcAgent.java - Tool call recorder → MCP calculator server: delegates calls
src/main/java/com/calc/mcpclient/agent/RecordingToolCallback.java - Tool call recorder → Tool call record: records calls
src/main/java/com/calc/mcpclient/agent/RecordingToolCallback.java - Chat response → Tool call record: includes calls
src/main/java/com/calc/mcpclient/dto/ChatResponse.java - Chat interaction → Tool call record: shows trace
src/main/resources/static/js/chat.js - MCP calculator agent → Anthropic model: invokes via client
- MCP calculator agent → Unavailable error: throws on failure
src/main/java/com/calc/mcpclient/agent/McpCalcAgent.java