🎓 Canvas LMS MCP-Server

Ein robuster Model Context Protocol (MCP)-Server, der Claude AI mit Ihrem Canvas LMS-Konto verbindet – so können Sie mit Ihren Kursarbeiten in natürlicher Sprache interagieren.

Erstellt mit Python · Canvas REST API · MCP SDK

✨ Funktionen (14 Tools in 4 Modulen)

📚 Aufgaben & Kurse

Tool	Beschreibung
`canvas_get_course_list`	Alle aktiven eingeschriebenen Kurse auflisten
`canvas_get_assignments`	Alle Aufgaben abrufen (alle Kurse oder gefiltert)
`canvas_get_upcoming_deadlines`	Fristen in den nächsten N Tagen, farblich nach Dringlichkeit kodiert
`canvas_get_assignment_details`	Vollständige Details zu einer bestimmten Aufgabe
`canvas_get_submission_status`	Eingereicht vs. fehlend über alle Kurse hinweg

📊 Noten

Tool	Beschreibung
`canvas_get_course_grades`	Aktuelle Noten mit visuellen Fortschrittsbalken
`canvas_get_grade_breakdown`	Aufschlüsselung auf Aufgabenebene mit laufender Gesamtsumme
`canvas_get_missing_assignments`	Alle nicht eingereichten Aufgaben

📢 Ankündigungen & Module

Tool	Beschreibung
`canvas_get_announcements`	Aktuelle Ankündigungen über alle Kurse hinweg
`canvas_get_course_modules`	Module mit Status (gesperrt/abgeschlossen)
`canvas_get_module_items`	Elemente in einem Modul mit Kontrollkästchen für den Abschluss

📅 Kalender

Tool	Beschreibung
`canvas_get_calendar_events`	Alle Ereignisse für die nächsten N Tage
`canvas_get_weekly_schedule`	Wochenübersicht
`canvas_get_upcoming_events`	Nächste N Ereignisse über alle Kurse hinweg

🚀 Einrichtung

1. Repo klonen

git clone https://github.com/yourusername/canvas-mcp.git
cd canvas-mcp

2. Abhängigkeiten installieren

pip install -r requirements.txt

3. Canvas-Anmeldedaten konfigurieren

cp .env.example .env

Bearbeiten Sie .env:

CANVAS_BASE_URL=https://yourschool.instructure.com
CANVAS_API_TOKEN=your_token_here

So erhalten Sie Ihr Canvas-API-Token:

Melden Sie sich bei Canvas an
Gehen Sie zu Konto → Einstellungen
Scrollen Sie zu Zugelassene Integrationen
Klicken Sie auf Neues Zugriffstoken
Kopieren Sie das Token in Ihre .env-Datei

4. Claude Desktop konfigurieren

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "canvas": {
      "command": "python",
      "args": ["/absolute/path/to/canvas-mcp/server.py"],
      "env": {
        "CANVAS_BASE_URL": "canvas_base_url"
        "CANVAS_API_TOKEN": "your_token_here"
      }
    }
  }
}

5. Claude Desktop neu starten

Die Canvas-Tools erscheinen nun in Ihrer Claude-Seitenleiste!

💬 Beispiel-Prompts

Sobald die Verbindung hergestellt ist, versuchen Sie, Claude zu fragen:

"Welche Aufgaben sind diese Woche fällig?"
"Wie hoch ist mein aktueller Notendurchschnitt?"
"Fehlen mir irgendwelche Aufgaben?"
"Welche Ankündigungen haben meine Dozenten kürzlich gepostet?"
"Zeige mir meine Notenaufschlüsselung für Kurs 12345"
"Wie sieht meine Woche aus?"

🗂️ Projektstruktur

canvas-mcp/
├── server.py           # MCP server entry point (14 tools)
├── canvas_client.py    # Canvas REST API wrapper with pagination
├── tools/
│   ├── assignments.py  # Assignment & course tools
│   ├── grades.py       # Grade tools
│   ├── announcements.py# Announcement & module tools
│   └── calendar.py     # Calendar tools
├── .env.example        # Environment config template
├── requirements.txt
└── README.md

🔒 Datenschutz & Sicherheit

Schreibgeschützt — dieser Server schreibt, übermittelt oder modifiziert niemals Ihre Canvas-Daten

🛠️ Tech-Stack

Python 3.10+
MCP SDK — Model Context Protocol
httpx — Async-fähiger HTTP-Client
python-dotenv — Umgebungskonfiguration
Canvas LMS REST API

Canvas LMS MCP Server