Google Classroom MCP-Server

Ein MCP-Server (Model Context Protocol), der über Claude und andere KI-Assistenten, die das MCP-Protokoll unterstützen, Zugriff auf Google Classroom-Daten bietet.

Aufstellen

Voraussetzungen

Node.js (v16 oder höher)
Ein Google Cloud Platform-Projekt mit aktivierter Google Classroom API
OAuth 2.0-Clientanmeldeinformationen für die Google Classroom API

Installation

Installation über Smithery

So installieren Sie den Google Classroom MCP-Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @faizan45640/google-classroom-mcp-server --client claude

Manuelle Installation

Dieses Repository klonen
Installieren Sie Abhängigkeiten:

npm install

Platzieren Sie Ihre Google OAuth-Client-Anmeldeinformationen in einer Datei mit dem Namen credentials.json im Projektstammverzeichnis:

{
  "web": {
    "client_id": "YOUR_CLIENT_ID",
    "project_id": "YOUR_PROJECT_ID",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost:3000/auth/google/callback"]
  }
}

Mit Google authentifizieren:

node index.js auth

Dadurch wird ein Browserfenster geöffnet, um den OAuth-Flow abzuschließen und Ihre Anmeldeinformationen in tokens.json zu speichern.

Konfigurieren Sie Claude für die Verwendung dieses Servers, indem Sie claude_desktop_config.json aktualisieren (normalerweise in %APPDATA%\Claude\ ):

{
  "mcpServers": {
    "class": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR_DIRECTORY\\index.js"
      ]
    }
  }
}

Verwendung

Verfügbare Tools

Der Server bietet mehrere Tools für die Interaktion mit Google Classroom:

1. `courses` - Listen Sie alle Ihre Google Classroom-Kurse auf

Use the 'courses' tool to get a list of all your Google Classroom courses

2. `course-details` - Erhalten Sie detaillierte Informationen zu einem bestimmten Kurs

Use the 'course-details' tool with the courseId parameter to get details and announcements for a specific course

Parameter:

courseId : Die ID des Kurses (kann aus dem courses abgerufen werden)

3. `assignments` - Erhalten Sie Aufgaben für einen bestimmten Kurs

Use the 'assignments' tool with the courseId parameter to get assignments and your submissions for a specific course

Parameter:

courseId : Die ID des Kurses (kann aus dem courses abgerufen werden)

Beispiel-Eingabeaufforderungen für Claude

Zeigen Sie mir alle meine Google Classroom-Kurse
Details zu meinem Mathematikkurs mit der ID 123456789 erhalten
Zeige mir alle Aufgaben für meinen Geschichtskurs mit der ID 987654321

Berechtigungen

Der Server fordert die folgenden Google Classroom API-Berechtigungen an:

classroom.courses.readonly – Um auf Kursinformationen zuzugreifen
classroom.announcements.readonly – Um auf Kursankündigungen zuzugreifen
classroom.coursework.me.readonly – Um auf Ihre Kursarbeiten und Aufgaben zuzugreifen
classroom.rosters.readonly – Für den Zugriff auf Klassenlisten

Fehlerbehebung

Wenn Berechtigungsfehler auftreten, versuchen Sie:

Führen Sie den Authentifizierungsbefehl erneut aus, um die Berechtigungen zu aktualisieren:
node index.js auth
Stellen Sie sicher, dass Ihr Google-Konto als Testbenutzer in der Google Cloud Console hinzugefügt wird, wenn sich Ihre App im Testmodus befindet
Überprüfen Sie die OAuth-Bereiche in der Funktion authenticateAndSaveCredentials , um sicherzustellen, dass sie Ihren Anforderungen entsprechen.

Hinweise

Dieser Server ist für die Verwendung mit Claude AI oder anderen MCP-kompatiblen Assistenten konzipiert
Alle API-Anfragen werden über Ihr authentifiziertes Google-Konto gestellt
Die Token-Aktualisierung erfolgt automatisch durch den Server.
Vertrauliche Anmeldeinformationen werden lokal in der Datei tokens.json gespeichert

Google Classroom MCP Server

Integrations