eclass-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@eclass-mcp What are the deadlines for my courses this semester?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
eclass-mcp
MCP server για το Open eClass των ελληνικών πανεπιστημίων. Συνδέεται με τον λογαριασμό σου στο eClass και δίνει σε ένα πρόγραμμα AI (Claude Desktop, Claude Code, Cursor κ.ά.) πρόσβαση στα:
μαθήματά σου
ανακοινώσεις, από όλα τα μαθήματα ή από ένα
προθεσμίες εργασιών και ασκήσεων, ημερολόγιο
εργασίες, με κατάσταση υποβολής και βαθμό
ασκήσεις (quiz)
έγγραφα και υλικό, με κατέβασμα αρχείων
μηνύματα
Μόνο διαβάζει. Δεν υποβάλλει, δεν στέλνει και δεν αλλάζει τίποτα στο eClass.
Φτιάχτηκε για το eClass του Πανεπιστημίου Θεσσαλίας (eclass.uth.gr). Για άλλο πανεπιστήμιο δες στο τέλος.
Εγκατάσταση
Χρειάζεται Python 3.10 ή νεότερο και το uv.
git clone https://github.com/fotispetrou/eclass-mcp
cd eclass-mcp
uv syncRelated MCP server: Quirkus
Στοιχεία σύνδεσης
Αποθήκευσε μία φορά το όνομα χρήστη και τον κωδικό σου του eClass στον κωδικοφύλακα του συστήματος (στα Windows είναι το Credential Manager):
uv run eclass-mcp loginΕναλλακτικά βάλε τα στις μεταβλητές περιβάλλοντος ECLASS_USERNAME και
ECLASS_PASSWORD. Ο κωδικός δεν φεύγει από τον υπολογιστή σου, πηγαίνει μόνο
στο eClass.
Δοκίμασε ότι όλα δουλεύουν:
uv run eclass-mcp checkΣύνδεση με Claude Desktop ή Cursor
Στο αρχείο ρυθμίσεων (claude_desktop_config.json ή mcp.json) πρόσθεσε:
{
"mcpServers": {
"eclass": {
"command": "uv",
"args": ["--directory", "C:/path/to/eclass-mcp", "run", "eclass-mcp"]
}
}
}Βάλε τη διαδρομή όπου έκανες το clone. Αν δεν χρησιμοποίησες τον κωδικοφύλακα,
πρόσθεσε και "env": {"ECLASS_USERNAME": "...", "ECLASS_PASSWORD": "..."}.
Για Claude Code:
claude mcp add eclass -- uv --directory C:/path/to/eclass-mcp run eclass-mcpΜετά ρωτάς απλά: «τι προθεσμίες έχω τον επόμενο μήνα;», «ποιες είναι οι τελευταίες ανακοινώσεις στα Δίκτυα;», «κατέβασε τις διαφάνειες του μαθήματος».
Εργαλεία
εργαλείο | τι κάνει |
| τα μαθήματά σου |
| ανακοινώσεις, όλες ή ενός μαθήματος |
| το πλήρες κείμενο μιας ανακοίνωσης |
| προθεσμίες και γεγονότα ημερολογίου για τις επόμενες μέρες |
| εργασίες ενός μαθήματος και λεπτομέρειες μιας εργασίας |
| ασκήσεις ενός μαθήματος |
| έγγραφα μαθήματος και κατέβασμα αρχείου ή φακέλου |
| μηνύματα και πλήρες κείμενο ενός μηνύματος |
| ποια εργαλεία έχει ενεργά ένα μάθημα |
| έλεγχος ότι η σύνδεση δουλεύει |
Ο κωδικός μαθήματος είναι αυτός στη διεύθυνση του μαθήματος, π.χ. για
.../courses/DS101/ είναι DS101.
Άλλο πανεπιστήμιο
Βάλε τη διεύθυνση του eClass σου στη μεταβλητή ECLASS_URL (π.χ.
https://eclass.upatras.gr) και τρέξε uv run eclass-mcp check. Δουλεύει με
Open eClass 3.x που έχει απλή φόρμα σύνδεσης. Πανεπιστήμια με κεντρικό login
(SSO, π.χ. ΕΚΠΑ) δεν υποστηρίζονται ακόμα.
Άδεια
MIT
Available Tools
13 toolsdownload_documentA
Download a document (or a whole folder as a zip) by its path from
list_documents. Saves under ~/Downloads/eclass// unless a destination
directory is given, and returns the local file path.
Inputs: path (required), course (required), destination.
get_announcementC
Full text of one announcement.
Inputs: course (required), announcement_id (required).
get_announcementsA
Latest announcements across all courses, or for one course if a code is given. Bodies are plain text; use get_announcement for the full text of one.
Inputs: limit, course, search. Returns: result
get_assignmentB
Details of one assignment: description, attached files, deadline, and the student's own submission if there is one.
Inputs: course (required), assignment_id (required).
get_assignmentsC
Assignments of a course with deadline, submission status and grade.
Inputs: course (required). Returns: result
get_course_toolsC
Which modules (documents, assignments, exercises, forum...) a course has enabled.
Inputs: course (required). Returns: result
get_deadlinesA
Upcoming calendar events for all courses: assignment and exercise deadlines,
agenda entries, teleconferences and personal events. Looks days ahead and
past_days back from now.
Inputs: days, course, past_days. Returns: result
get_exercisesB
Exercises (quizzes) of a course with their availability window and whether the student has attempted them.
Inputs: course (required). Returns: result
get_messageB
Full text of one message, with sender, recipients and attachment if any.
Inputs: message_id (required), mailbox.
get_messagesC
Personal and course messages. mailbox is 'inbox' or 'outbox'.
Inputs: limit, search, mailbox. Returns: result
list_coursesA
List the courses the student is enrolled in, with code, title and teachers.
Inputs: no named parameters. Returns: result
list_documentsB
Files and folders in a course's Documents area. Pass a folder's path to
list inside it.
Inputs: course (required), path. Returns: result
whoamiA
Check that the login works and see which account and eClass site are in use.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool maps to a distinct resource or action, and the plural/singular pairs (get_announcements vs get_announcement, get_assignments vs get_assignment, get_messages vs get_message) are explicitly cross-referenced in descriptions to steer selection. Minor overlap remains between get_deadlines and get_assignments (both surface assignment deadlines), but the framing as calendar vs. course context keeps them separable.
Nearly all tools follow a snake_case verb_noun pattern (list_courses, get_assignment, download_document). Deviations are minor: 'whoami' breaks the pattern entirely, and the set mixes 'list_' and 'get_' for resource enumeration in ways that are not strictly principled (list_documents but get_assignments).
Thirteen tools is squarely in the sweet spot for an LMS client and each one covers a distinct area (auth, courses, deadlines, assignments, exercises, documents, messages). No tool appears redundant or filler.
The surface is entirely read-only: a student can inspect assignments and submissions but cannot submit, upload, or post anything, and get_course_tools advertises forum modules that have no corresponding read tool. Announcements, assignments, exercises, documents and messages are covered, but the lifecycle stops at viewing, leaving notable dead ends for a student-facing client.
Maintenance
Related MCP Connectors
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
Give Claude a second brain for your notes, tasks and contacts. OAuth; it can't delete anything.
Connect a user's Google Calendar, Gmail, Drive, Notion or Slack so your agent reads their data.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables an AI agent to access a user's MyCourseVille account to retrieve assignments with deadlines, course materials, released grades, and a feed of what has changed since the last sync.102-
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to read courses, upcoming deadlines, assignment details, grades, announcements, modules, files, inbox, and timetable from U of T Quercus and ACORN through read-only tools.1MIT
- AlicenseBqualityCmaintenanceConnects Claude to your Moodle account through the same web-service API the mobile app uses. Enables asking about upcoming and overdue deadlines, reading course files and announcements, checking grades, searching course content, and saving assignment submissions from chat.172MIT
- AlicenseNot gradedqualityBmaintenanceEnables an AI agent to access a Moodle Campus Virtual account with the user's own credentials, reading course content, files, forums, notices, calendar, grades and quiz attempts for every enrolled course. Teachers, managers and course creators also get access to other participants' data and to planned, verified write operations such as forums, grading, attendance, quizzes, groups, content and H5P activities.4Apache 2.0