Juno ERP MCP Client

A modular Model Context Protocol (MCP) server for interacting with MGMU Juno ERP. This client exposes various student-related data as tools for use with LLMs (like Claude).

🚀 Features

• Profile Management: Fetch student personal information and academic info.

• Attendance: Get detailed attendance records and visual graph data.

• Fees & Admission: Check remaining fees, fee structure, and admission details.

• Academics: Fetch today's schedule, exam results, and course lists for specific terms.

• Search: Search for students within the ERP.

🛠️ Setup

1. Install Dependencies:

   npm install

2. Configure Environment: Copy .env.example to .env and fill in your credentials:

   cp .env.example .env

   Edit .env:

   email=your_email@example.com
   password=your_password
   PORT=8987

3. Build the Project:

   npm run build

🏃 Running the Server

Development Mode

Runs the server using tsx for live development:

npm run dev

Production Mode

Builds and runs the compiled JavaScript:

npm run build
npm start

The server will be available at http://localhost:8987/mcp.

🐳 Docker Support

The Docker image is automatically built and published to GHCR: ghcr.io/danish-mar/juno-mcp:master

You can run the server using Docker and Docker Compose:

1. Build and Start:

   docker-compose up -d --build

2. Check Logs:

   docker logs -f juno-mcp

3. Stop:

   docker-compose down

🛠️ Available Tools

🔒 Security

• Credentials are never hardcoded and are loaded from .env.

• .env is included in .gitignore to prevent accidental exposure.

• Session tokens are managed in-memory and refreshed automatically upon expiry.

📄 License

ISC