# Studie+ MCP Server

MCP server der giver Claude Desktop (og andre MCP-klienter) adgang til skoledata fra [Studie+](https://studieplus.dk) — den danske skoleplatform.

Spørg Claude om dit skema, lektier, afleveringer og filer direkte i chatten.

## Features

- **Dagsoverblik** — skema, lektier, noter og afleveringer for en given dag
- **Ugeoverblik** — komplet ugeskema med lektier og deadlines
- **Afleveringer** — filtrer på fag, deadline, eller vis alle
- **Afleveringsdetaljer** — beskrivelse, filer og status
- **Lektionsfiler** — hent filer fra lektioner med signerede download-URLs
- **Fil-download** — download filer direkte til din computer
- **Letvægts-scraper** — bruger HTTP direkte (ingen browser, ~30MB RAM)
- **Cross-platform** — virker på Windows, Mac og Linux

## Setup

### 1. Installer dependencies

```bash
cd studieplus-mcp
pip install -r requirements.txt
```

### 2. Konfigurer credentials

Opret en `.env` fil:
```
STUDIEPLUS_USERNAME=dit_brugernavn
STUDIEPLUS_PASSWORD=dit_kodeord
STUDIEPLUS_SCHOOL=DIN_SKOLE
```

### 3. Tilføj til Claude Desktop

Rediger Claude Desktop config:
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
- **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "studieplus": {
      "command": "python",
      "args": [
        "/sti/til/studieplus-mcp/src/mcp_server/server.py"
      ],
      "env": {
        "STUDIEPLUS_USERNAME": "dit_brugernavn",
        "STUDIEPLUS_PASSWORD": "dit_kodeord",
        "STUDIEPLUS_SCHOOL": "DIN_SKOLE"
      }
    }
  }
}
```

> Udskift `/sti/til/studieplus-mcp` med den faktiske sti til projektet.

### 4. Genstart Claude Desktop

Genstart Claude Desktop for at indlæse MCP serveren.

## Brug

Når serveren er installeret, kan du spørge Claude:

- "Hvad har jeg i dag?"
- "Har jeg lektier til i morgen?"
- "Hvad skal jeg aflevere?"
- "Hvilket lokale skal jeg møde i?"
- "Hvornår starter jeg i morgen?"
- "Har jeg dansk afleveringer?"
- "Hvad har jeg i næste uge?"
- "Download filerne fra min dansktime"

## MCP Tools

| Tool | Beskrivelse |
|------|-------------|
| `get_day_overview(day_offset)` | Skema, lektier, noter og afleveringer for en dag |
| `get_week_overview(week_offset)` | Komplet ugeoverblik |
| `get_assignments(include_submitted, days_ahead, subject)` | Afleveringer med filtrering |
| `get_assignment_details(assignment_id)` | Detaljer for en specifik aflevering |
| `get_lesson_files(lesson_id)` | Filer fra en lektion med download-URLs |
| `download_lesson_file(file_url, file_name)` | Download en fil til brugerens computer |
| `load_lesson_file(file_url, file_name)` | Indlæs filindhold direkte |

## Arkitektur

```
src/
  mcp_server/
    server.py              # MCP tools (thin wrapper)
  studieplus_scraper/
    requests_scraper.py    # HTTP-baseret GWT-RPC scraper
    gwt_deserializer.py    # Stack-baseret GWT response parser
    api.py                 # API lag (business logic, caching)
    scraper.py             # Playwright-baseret scraper (outdated, fallback)
```

Scraperen kommunikerer direkte med Studie+ via GWT-RPC protokollen — ingen browser nødvendig.

> **Note:** Der findes også en Playwright-baseret scraper (`scraper.py`) som kan bruges som fallback. Den er outdated og mangler nogle features, men kan aktiveres med `USE_PLAYWRIGHT_SCRAPER=true`. Kræver `pip install playwright && playwright install chromium`.

## Transport

Serveren understøtter to transport-modes:

- **stdio** (default) — til Claude Desktop
- **SSE** — til Docker/Raspberry Pi deployment

```bash
# SSE mode
MCP_TRANSPORT=sse MCP_PORT=8101 python src/mcp_server/server.py
```

## Licens

MIT