What can you do with this server?

The eClass MCP Server enables AI agents to interact with Open eClass platforms, specifically tailored for UoA's SSO authentication system. Capabilities include: * **Authentication**: Log in to eClass via UoA's CAS SSO system using configured credentials * **Course Management**: Retrieve a list of enrolled courses on eClass * **Session Management**: Maintain authenticated sessions for continuous interaction across tool calls * **Status Checking**: Verify the current authentication status with eClass * **Logout**: End the eClass session when needed * **Security**: Handle sensitive credentials securely, maintaining session cookies in memory * **Integration**: Designed to work with AI agents supporting the Model Context Protocol for accessing course materials and announcements

Which integrations are available for this server?

Uses [.env](/mcp/servers/integrations/dotenv) files to store sensitive authentication credentials for eClass, maintaining them securely outside of version control Hosts the project repository for version control and distribution of the eClass MCP server code Built with [Python](/mcp/servers/integrations/python), providing a foundation for the MCP server implementation that handles authentication and interactions with eClass Implements [session](/mcp/servers/integrations/session) management to maintain authenticated state between interactions with the eClass platform

The eClass MCP Server enables AI agents to interact with Open eClass platforms, specifically tailored for UoA's SSO authentication system.

Capabilities include:

Authentication: Log in to eClass via UoA's CAS SSO system using configured credentials
Course Management: Retrieve a list of enrolled courses on eClass
Session Management: Maintain authenticated sessions for continuous interaction across tool calls
Status Checking: Verify the current authentication status with eClass
Logout: End the eClass session when needed
Security: Handle sensitive credentials securely, maintaining session cookies in memory
Integration: Designed to work with AI agents supporting the Model Context Protocol for accessing course materials and announcements

eClass MCP Server

An MCP server for interacting with the Open eClass platform, with support for UoA's SSO authentication.

Features

SSO Authentication: Log in through UoA's CAS SSO system
Course Retrieval: Get list of enrolled courses
Session Management: Persistent sessions between tool calls
Status Checking: Verify authentication status

Related MCP server: Google Classroom MCP Server

Quick Start

Prerequisites

Python 3.10+
uv (recommended) or pip

Installation

git clone https://github.com/sdi2200262/eclass-mcp-server.git cd eclass-mcp-server uv sync --dev --all-extras

Configuration

Create a .env file (or copy example.env):

ECLASS_USERNAME=your_username ECLASS_PASSWORD=your_password

Optional settings:

ECLASS_URL=https://eclass.uoa.gr # Default ECLASS_SSO_DOMAIN=sso.uoa.gr # Default ECLASS_SSO_PROTOCOL=https # Default

Running

# Using the entry point script python run_server.py # Or as a module python -m src.eclass_mcp_server.server

MCP Client Configuration

To use this MCP server with Claude Desktop, VS Code, Cursor, or any MCP-compatible client, configure your client to run:

python3 /absolute/path/to/eclass-mcp-server/run_server.py

Set the following environment variables in your client's MCP configuration:

{ "env": { "ECLASS_USERNAME": "your_username", "ECLASS_PASSWORD": "your_password" } }

Optional environment variables:

ECLASS_URL - OpenEclass instance URL (default: https://eclass.uoa.gr)
ECLASS_SSO_DOMAIN - SSO domain (default: sso.uoa.gr)
ECLASS_SSO_PROTOCOL - SSO protocol (default: https)

Refer to your specific client's documentation for how to add MCP servers to your configuration.

Available Tools

Tool	Description
`login`	Authenticate using credentials from `.env`
`get_courses`	Retrieve enrolled courses (requires login)
`logout`	End the current session
`authstatus`	Check authentication status

All tools use a dummy random_string parameter (MCP protocol requirement).

Standalone Client

For non-MCP usage, a standalone client is included:

python eclass_client.py

This demonstrates the core functionality without MCP integration. See docs/architecture.md for details.

Documentation

Architecture - System design and authentication flow
Wire Protocol - JSON-RPC message formats
Tools Reference - Detailed tool documentation

Project Structure

eclass-mcp-server/ ├── run_server.py # Entry point ├── eclass_client.py # Standalone client (non-MCP) ├── src/eclass_mcp_server/ # Main package │ ├── server.py # MCP server and tool handlers │ ├── authentication.py # SSO authentication │ ├── course_management.py # Course operations │ ├── html_parsing.py # HTML parsing utilities │ └── test/ # Test scripts └── docs/ # Documentation

Security

Credentials are stored locally in .env only
Never passed as tool parameters (preventing AI provider exposure)
Sessions maintained in-memory only
No cloud services or remote storage

License

GNU GPL v3.0 - This ensures transparency in credential handling.

Acknowledgments

GUnet for the Open eClass platform
This project is an independent interface, not affiliated with GUnet

eClass MCP Server

eClass MCP Server

Features

Quick Start

Prerequisites

Installation

Configuration

Running

MCP Client Configuration

Available Tools

Standalone Client

Documentation

Project Structure

Security

License

Acknowledgments

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API