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

1. Clonar este repositorio

2. Instalar dependencias:

npm install

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

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

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

Related MCP server: gscope

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

1. Muéstrame todos mis cursos de Google Classroom

2. Obtenga detalles de mi curso de Matemáticas con ID 123456789

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

1. Ejecute nuevamente el comando auth para actualizar los permisos:

   node index.js auth

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

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