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 :
Instalación manual
Clonar este repositorio
Instalar dependencias:
Coloque sus credenciales de cliente de Google OAuth en un archivo llamado
credentials.jsonen la raíz del proyecto:
Autenticarse con Google:
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\):
Related MCP server: Google API Discovery Service MCP Server
Uso
Herramientas disponibles
El servidor proporciona varias herramientas para interactuar con Google Classroom:
1. courses : enumera todos tus cursos de Google Classroom
2. course-details : obtenga información detallada sobre un curso específico
Parámetros:
courseId: El ID del curso (se puede obtener desde la herramientacourses)
3. assignments : obtenga tareas para un curso específico
Parámetros:
courseId: El ID del curso (se puede obtener desde la herramientacourses)
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 cursoclassroom.announcements.readonly- Para acceder a los anuncios del cursoclassroom.coursework.me.readonly- Para acceder a sus trabajos y tareas del cursoclassroom.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 authCó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
authenticateAndSaveCredentialspara 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