eClass MCP Server
by sdi2200262
An MCP server for interacting with Open eClass platform instances, with specific support for UoA's SSO authentication system. This server enables AI agents to authenticate with eClass, retrieve course information, and perform basic operations on the platform.
Last updated: N/A
What is eClass MCP Server?
The eClass MCP Server is a Model Context Protocol (MCP) server designed to facilitate interaction with Open eClass platforms, particularly those using the University of Athens' (UoA) Single Sign-On (SSO) authentication system. It allows AI agents to securely access and manipulate eClass data.
How to use eClass MCP Server?
To use the server, first clone the repository and install the dependencies using UV or pip. Configure the .env file with your eClass credentials. Then, run the server using python run_server.py. Configure your MCP client (like Cursor or Claude Desktop) to connect to the server using the provided instructions.
Key features of eClass MCP Server
Authentication via UoA's CAS SSO
Course Management (retrieving enrolled courses)
Session Management
Authentication Status Checking
Use cases of eClass MCP Server
AI agents retrieving course information
AI agents checking course announcements
AI agents accessing course materials
AI agents submitting assignments (future feature)
FAQ from eClass MCP Server
Where do I store my eClass credentials?
Where do I store my eClass credentials?
Store your credentials in the .env file in the root directory. Never commit this file to version control.
Can I pass credentials as parameters to the tools?
Can I pass credentials as parameters to the tools?
No, the server does not accept credentials as parameters. All credentials must be provided in the .env file.
Is this server secure?
Is this server secure?
The server is designed with security as a top priority. It runs locally, does not use cloud services, and stores credentials only in the .env file. AI clients never receive your credentials directly.
What license is this project under?
What license is this project under?
This project is licensed under the GNU General Public License v3.0.
How do I run the tests?
How do I run the tests?
Use the commands python -m src.eclass_mcp_server.test.run_all_tests to run all tests or python -m src.eclass_mcp_server.test.test_login and python -m src.eclass_mcp_server.test.test_courses to run specific tests.