eClass (UoA)

eClass MCP Server

Features

**Authentication**: Log in to eClass through UoA's CAS SSO authentication system

**Course Management**: Retrieve lists of enrolled courses

**Session Management**: Maintain authenticated sessions between tool calls

**Status Checking**: Verify authentication status

Project Structure

This project follows a modular architecture for better maintainability:

Installation

Install the server using UV (recommended):

Alternatively, install with pip:

Configuration

Create a `.env` file in the root directory with the following configuration (or copy and rename the provided `example.env` file):

All credentials must be provided in the .env file. The server does not accept credentials as parameters.

Usage

Terminal

Run the server using the entry point script:

Or as a module:

Cursor

( as of version 0.48 ) Go to Settings -> MCP. Click on `Add new global MCP server`:

This will open the global `mcp.json` file:

Or try this path format on the `args` field:

This command runs the `run_server.py` script that connects the MCP Client with the main server entry point in `server.py`.

Claude Desktop

To use with Claude Desktop:

Open Claude Desktop

Go to Settings > Server

Add a new server with the following details: - Name: eClass MCP - Command: Path to your run_server.py script

Click Add Server

Select the server from the dropdown when chatting with Claude

Tools

The server provides the following tools for use with MCP clients:

login

get_courses

Retrieve a list of enrolled courses (requires login first).

logout

Log out from eClass.

authstatus

Check the current authentication status.

eClass Client (Non-MCP)

The repository includes `eclass_client.py`, a standalone client for interacting with the eClass platform. This was the initial implementation that inspired the creation of the MCP server.

Features of eClass Client

Pure Python implementation without MCP integration

Handles the complete authentication flow with UoA's SSO system

Retrieves course information from eClass

Provides clean logout functionality

This client serves as both:

A reference implementation for understanding the eClass authentication flow

A simpler alternative for projects that don't require MCP integration

You can run the client directly:

Testing

The project includes test scripts to verify functionality:

Documentation

Comprehensive documentation is available in the `docs/` directory:

[Documentation Overview](docs/README.md)

[How It Works](docs/how-it-works.md)

[MCP SDK Integration](docs/mcp-sdk-integration.md)

[Tools Reference](docs/tools-reference.md)

Example MCP Client Usage

Integration with AI Agents

This MCP server is designed to be used with AI agents that support the Model Context Protocol. This enables AI systems to interact with eClass directly, allowing for capabilities like:

Retrieving course information

Checking course announcements

Accessing course materials

Submitting assignments (future feature)

Security

The eClass MCP Server is designed with security as a top priority, particularly regarding credential handling:

Local-Only Execution

**No Cloud Services**: The MCP server runs entirely on your local machine, with no cloud components

**No Remote Storage**: Credentials and session data never leave your local environment

**User-Controlled**: You maintain complete control over your authentication data

Credential Protection

**Environment Variables Only**: Credentials are stored exclusively in the local `.env` file

**Never Passed as Parameters**: All tools are designed to use dummy parameters (e.g., `random_string`)

**AI Client Isolation**: AI clients (like Claude or other LLMs) never receive your credentials - This prevents credentials from being: - Stored in AI provider logs - Included in model training data - Processed on remote servers

Session Management

**In-Memory Sessions**: Session cookies and state are maintained only in memory

**No Persistence**: Session data is not stored between runs

**Direct Authentication**: The MCP server communicates directly with eClass, with no intermediaries, apart from your University's CAS mechanism.

Recommended Practices

Store your `.env` file securely and never commit it to version control

Run the server only on trusted machines

Dont pass the parameters to an MCP client through any prompts, they will not be used by the Server and will be accessed by the AI Agent provider

License

GNU General Public License v3.0

This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.

What this means for you

The GPL-3.0 license is a strong copyleft license that requires anyone who distributes this code or derivative works to make the source code available under the same terms. Key points:

**Freedom to use**: You can use this software for any purpose

**Freedom to study**: You can examine the source code to see how it works

**Freedom to share**: You can redistribute the software

**Freedom to modify**: You can adapt the software to your needs

Why we chose GPL-3.0

We chose the GPL-3.0 license to:

**Protect user security**: Ensures that any modifications handling credentials must be open source, allowing users to verify security implementations

**Promote sharing**: Encourages contributions back to the community

**Prevent abuse**: Makes it harder for malicious actors to create closed-source derivatives that might compromise security

**Match ecosystem values**: Aligns with the values of the Open eClass platform, which is also open source

This license is particularly important for this software since it handles authentication and sensitive credentials. The GPL-3.0 ensures that any modifications to this code remain transparent, allowing users to verify how their credentials are being handled.

Acknowledgments

[GUnet (Greek Universities Network)](https://github.com/gunet) for developing and maintaining the [Open eClass platform](https://github.com/gunet/openeclass), an open-source learning management system used by academic institutions throughout Greece.

The Open eClass platform is distributed as free Open Source Software under GNU GPL v2.0, making projects like this MCP integration possible.

Special thanks to the Asynchronous eLearning Team of GUnet for their continuous development and improvement of the eClass platform.

This project is an independent interface to the Open eClass system and is not affiliated with or endorsed by GUnet. It respects the Terms of Service of the eClass platform and uses proper authentication mechanisms.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.