Skip to main content
Glama
README.md
# eclass-mcp

MCP server για το Open eClass των ελληνικών πανεπιστημίων. Συνδέεται με τον
λογαριασμό σου στο eClass και δίνει σε ένα πρόγραμμα AI (Claude Desktop, Claude
Code, Cursor κ.ά.) πρόσβαση στα:

- μαθήματά σου
- ανακοινώσεις, από όλα τα μαθήματα ή από ένα
- προθεσμίες εργασιών και ασκήσεων, ημερολόγιο
- εργασίες, με κατάσταση υποβολής και βαθμό
- ασκήσεις (quiz)
- έγγραφα και υλικό, με κατέβασμα αρχείων
- μηνύματα

Μόνο διαβάζει. Δεν υποβάλλει, δεν στέλνει και δεν αλλάζει τίποτα στο eClass.

Φτιάχτηκε για το eClass του Πανεπιστημίου Θεσσαλίας (eclass.uth.gr). Για άλλο
πανεπιστήμιο δες στο τέλος.

## Εγκατάσταση

Χρειάζεται Python 3.10 ή νεότερο και το [uv](https://docs.astral.sh/uv/).

```
git clone https://github.com/fotispetrou/eclass-mcp
cd eclass-mcp
uv sync
```

## Στοιχεία σύνδεσης

Αποθήκευσε μία φορά το όνομα χρήστη και τον κωδικό σου του 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`) πρόσθεσε:

```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

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