MANIT Student ERP MCP Server 🚀

A production-ready Model Context Protocol (MCP) Server built with Java 21, Spring Boot 3.3+, and Spring AI MCP Server. This server securely connects to university ERP endpoints (erpapi.manit.ac.in) and exposes student academic, registration, and fee details as high-value AI Tools for Claude Desktop and GitHub Copilot Chat.

---

🏛️ Architecture Overview

The MCP server follows Clean Architecture principles, ensuring strict separation of concerns, immutability via Java 21 Records, and zero raw ERP data leakage to the LLM.

                      [ Claude Desktop / GitHub Copilot Chat ]
                                         │
                                   (STDIO / SSE)
                                         │
                                         ▼
                            ┌─────────────────────────┐
                            │      AcademicTools      │  <-- MCP Tools Layer (@Tool)
                            └────────────┬────────────┘
                                         │
                        ┌────────────────┴────────────────┐
                        ▼                                 ▼
              ┌──────────────────┐               ┌──────────────────┐
              │ AcademicService  │               │    FeeService    │  <-- Service Layer
              └────────┬─────────┘               └────────┬─────────┘
                       │                                  │
                       └────────────────┬─────────────────┘
                                        │
                                        ▼
                             ┌─────────────────────┐
                             │    ErpDataMapper    │  <-- DTO Transformation
                             └──────────┬──────────┘
                                        │
             ┌──────────────────────────┼──────────────────────────┐
             ▼                          ▼                          ▼
   ┌───────────────────┐      ┌───────────────────┐      ┌───────────────────┐
   │  ResultApiClient  │      │RegistrationClient │      │   FeeApiClient    │ <-- WebClient
   └─────────┬─────────┘      └─────────┬─────────┘      └─────────┬─────────┘
             │                          │                          │
             └──────────────────────────┼──────────────────────────┘
                                        │ (HTTP GET with JSON Payload)
                                        ▼
                          [ erpapi.manit.ac.in REST APIs ]

Key Architectural Layers

1. MCP Tool Layer (tools): Exposes domain capabilities (getAcademicSummary, getSemesterDetails, getSubjectDetails, getRegistrationInfo, getFeeInfo, searchAcademicRecords, getStudentDashboard) with rich metadata for LLM tool selection.
2. Service Layer (services): Handles data aggregation, fee categorization, weighted CGPA calculations, and multi-endpoint data composition using Project Reactor (Mono.zip).
3. Mapper & DTO Layer (dto, mapper): Transforms verbose raw ERP responses into lightweight domain records to save LLM context tokens.
4. ERP WebClient Layer (clients): Manages HTTP GET calls with JSON bodies, header injection, exponential backoff retries, timeouts, and logging.
5. Configuration Layer (config): Externalized configuration properties (ErpProperties) and WebClient bean initialization.

---

🛠️ MCP Tools Reference