Servidor MCP de Google Classroom

Un servidor MCP (Protocolo de contexto de modelo) que proporciona acceso a los datos de Google Classroom a través de Claude y otros asistentes de IA que admiten el protocolo MCP.

Configuración

Prerrequisitos

Node.js (v16 o superior)
Un proyecto de Google Cloud Platform con la API de Google Classroom habilitada
Credenciales de cliente OAuth 2.0 para la API de Google Classroom

Instalación

Instalación mediante herrería

Para instalar Google Classroom MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

Clonar este repositorio
Instalar dependencias:

npm install

Coloque sus credenciales de cliente de Google OAuth en un archivo llamado credentials.json en la raíz del proyecto:

{
  "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"]
  }
}

Autenticarse con Google:

node index.js auth

Esto abrirá una ventana del navegador para completar el flujo OAuth y guardar sus credenciales en tokens.json .

Configure Claude para usar este servidor actualizando claude_desktop_config.json (normalmente en %APPDATA%\Claude\ ):

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

Uso

Herramientas disponibles

El servidor proporciona varias herramientas para interactuar con Google Classroom:

1. `courses` : enumera todos tus cursos de Google Classroom

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

2. `course-details` : obtenga información detallada sobre un curso específico

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

Parámetros:

courseId : El ID del curso (se puede obtener desde la herramienta courses )

3. `assignments` : obtenga tareas para un curso específico

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

Parámetros:

courseId : El ID del curso (se puede obtener desde la herramienta courses )

Ejemplos de indicaciones para Claude

Muéstrame todos mis cursos de Google Classroom
Obtenga detalles de mi curso de Matemáticas con ID 123456789
Muéstrame todas las tareas de mi curso de Historia con ID 987654321

Permisos

El servidor solicita los siguientes permisos de la API de Google Classroom:

classroom.courses.readonly - Para acceder a la información del curso
classroom.announcements.readonly - Para acceder a los anuncios del curso
classroom.coursework.me.readonly - Para acceder a sus trabajos y tareas del curso
classroom.rosters.readonly - Para acceder a las listas de clases

Solución de problemas

Si encuentra errores de permisos, intente:

Ejecute nuevamente el comando auth para actualizar los permisos:
node index.js auth
Cómo asegurarse de que su cuenta de Google se agregue como usuario de prueba en Google Cloud Console si su aplicación está en modo de prueba
Comprobación de los alcances de OAuth en la función authenticateAndSaveCredentials para garantizar que coincidan con sus necesidades

Notas

Este servidor está diseñado para usarse con Claude AI u otros asistentes compatibles con MCP
Todas las solicitudes de API se realizan utilizando su cuenta de Google autenticada
La actualización del token la gestiona automáticamente el servidor
Las credenciales confidenciales se almacenan localmente en el archivo tokens.json

Integrations