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

1. Dieses Repository klonen

2. Installieren Sie Abhängigkeiten:

npm install

3. 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"]
  }
}

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

5. 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"
      ]
    }
  }
}

Related MCP server: Google API Discovery Service MCP Server

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

1. Zeigen Sie mir alle meine Google Classroom-Kurse

2. Details zu meinem Mathematikkurs mit der ID 123456789 erhalten

3. 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:

1. Führen Sie den Authentifizierungsbefehl erneut aus, um die Berechtigungen zu aktualisieren:

   node index.js auth

2. Stellen Sie sicher, dass Ihr Google-Konto als Testbenutzer in der Google Cloud Console hinzugefügt wird, wenn sich Ihre App im Testmodus befindet

3. Ü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