Сервер 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

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

1. Клонировать этот репозиторий

2. Установите зависимости:

npm install

3. Поместите учетные данные клиента 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"]
  }
}

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

node index.js auth

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

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

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

Related MCP server: Google API Discovery Service MCP Server

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

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

Сервер предоставляет несколько инструментов для взаимодействия с 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 )

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

1. Покажите мне все мои курсы Google Classroom

2. Получить подробную информацию о моем курсе математики с идентификатором 123456789

3. Покажите мне все задания по моему курсу истории с идентификатором 987654321

Разрешения

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

• classroom.courses.readonly — для доступа к информации о курсе

• classroom.announcements.readonly — для доступа к объявлениям курса

• classroom.coursework.me.readonly — для доступа к вашим курсовым работам и заданиям

• classroom.rosters.readonly — для доступа к спискам классов

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

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

1. Повторный запуск команды auth для обновления разрешений:

   node index.js auth

2. Убедитесь, что ваша учетная запись Google добавлена в качестве тестового пользователя в Google Cloud Console, если ваше приложение находится в режиме тестирования.

3. Проверка областей OAuth в функции authenticateAndSaveCredentials , чтобы убедиться, что они соответствуют вашим потребностям

Примечания

• Этот сервер предназначен для использования с Claude AI или другими помощниками, совместимыми с MCP.

• Все запросы API выполняются с использованием вашей аутентифицированной учетной записи Google.

• Обновление токена выполняется сервером автоматически.

• Конфиденциальные учетные данные хранятся локально в файле tokens.json