Skip to main content
Glama

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 sync

Related 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

Μετά ρωτάς απλά: «τι προθεσμίες έχω τον επόμενο μήνα;», «ποιες είναι οι τελευταίες ανακοινώσεις στα Δίκτυα;», «κατέβασε τις διαφάνειες του μαθήματος».

Εργαλεία

εργαλείο

τι κάνει

list_courses

τα μαθήματά σου

get_announcements

ανακοινώσεις, όλες ή ενός μαθήματος

get_announcement

το πλήρες κείμενο μιας ανακοίνωσης

get_deadlines

προθεσμίες και γεγονότα ημερολογίου για τις επόμενες μέρες

get_assignments, get_assignment

εργασίες ενός μαθήματος και λεπτομέρειες μιας εργασίας

get_exercises

ασκήσεις ενός μαθήματος

list_documents, download_document

έγγραφα μαθήματος και κατέβασμα αρχείου ή φακέλου

get_messages, get_message

μηνύματα και πλήρες κείμενο ενός μηνύματος

get_course_tools

ποια εργαλεία έχει ενεργά ένα μάθημα

whoami

έλεγχος ότι η σύνδεση δουλεύει

Ο κωδικός μαθήματος είναι αυτός στη διεύθυνση του μαθήματος, π.χ. για .../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 tools
download_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

    B3.2/5.0

    Scored across 13 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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).

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      4
      Apache 2.0