Сервер MCP Google Classroom

Сервер MCP (Model Context Protocol), который обеспечивает доступ к данным Google Classroom через Claude и других помощников на базе искусственного интеллекта, поддерживающих протокол MCP.

Настраивать

Предпосылки

Node.js (v16 или выше)
Проект Google Cloud Platform с включенным Google Classroom API
Учетные данные клиента OAuth 2.0 для API Google Classroom

Установка

Установка через Smithery

Чтобы автоматически установить Google Classroom MCP Server для Claude Desktop через Smithery :

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

Установка вручную

Клонировать этот репозиторий
Установите зависимости:

npm install

Поместите учетные данные клиента Google OAuth в файл с именем credentials.json в корне проекта:

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

Аутентификация с помощью Google:

node index.js auth

Откроется окно браузера для завершения процесса OAuth и сохранения ваших учетных данных в tokens.json .

Настройте Claude для использования этого сервера, обновив claude_desktop_config.json (обычно в %APPDATA%\Claude\ ):

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

Использование

Доступные инструменты

Сервер предоставляет несколько инструментов для взаимодействия с Google Classroom:

1. `courses` — перечислите все свои курсы Google Classroom

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

2. `course-details` - Получите подробную информацию о конкретном курсе

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

Параметры:

courseId : идентификатор курса (можно получить с помощью инструмента courses )

3. `assignments` - Получите задания по определенному курсу

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

Параметры:

courseId : идентификатор курса (можно получить с помощью инструмента courses )

Примеры подсказок для Клода

Покажите мне все мои курсы Google Classroom
Получить подробную информацию о моем курсе математики с идентификатором 123456789
Покажите мне все задания по моему курсу истории с идентификатором 987654321

Разрешения

Сервер запрашивает следующие разрешения API Google Classroom:

classroom.courses.readonly — для доступа к информации о курсе
classroom.announcements.readonly — для доступа к объявлениям курса
classroom.coursework.me.readonly — для доступа к вашим курсовым работам и заданиям
classroom.rosters.readonly — для доступа к спискам классов

Поиск неисправностей

Если вы столкнулись с ошибками разрешений, попробуйте:

Повторный запуск команды auth для обновления разрешений:
node index.js auth
Убедитесь, что ваша учетная запись Google добавлена в качестве тестового пользователя в Google Cloud Console, если ваше приложение находится в режиме тестирования.
Проверка областей OAuth в функции authenticateAndSaveCredentials , чтобы убедиться, что они соответствуют вашим потребностям

Примечания

Этот сервер предназначен для использования с Claude AI или другими помощниками, совместимыми с MCP.
Все запросы API выполняются с использованием вашей аутентифицированной учетной записи Google.
Обновление токена выполняется сервером автоматически.
Конфиденциальные учетные данные хранятся локально в файле tokens.json

Google Classroom MCP Server

Integrations