Google Classroom MCP サーバー

Claude や MCP プロトコルをサポートするその他の AI アシスタントを通じて Google Classroom データへのアクセスを提供する MCP (Model Context Protocol) サーバー。

設定

前提条件

• Node.js (v16 以上)

• Google Classroom API が有効になっている Google Cloud Platform プロジェクト

• Google Classroom API の OAuth 2.0 クライアント認証情報

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Google Classroom MCP サーバーを自動的にインストールするには:

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_desktop_config.json (通常は%APPDATA%\Claude\内) を更新して、Claude がこのサーバーを使用するように設定します。

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

Related MCP server: gscope

使用法

利用可能なツール

サーバーは、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 : コースのID（ coursesツールから取得できます）

3. assignments - 特定のコースの課題を取得する

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

パラメータ:

• courseId : コースのID（ coursesツールから取得できます）

クロードの例題

1. Google Classroomのコースをすべて表示

2. ID 123456789 の私の数学コースの詳細をご覧ください

3. ID 987654321 の歴史コースのすべての課題を表示します

権限

サーバーは次の Google Classroom API 権限を要求します。

• classroom.courses.readonly - コース情報にアクセスする

• classroom.announcements.readonly - コースのアナウンスにアクセスする

• classroom.coursework.me.readonly - 授業や課題にアクセスするには

• classroom.rosters.readonly - クラス名簿にアクセスする

トラブルシューティング

権限エラーが発生した場合は、以下を試してください。

1. 権限を更新するには、再度 auth コマンドを実行します。

   node index.js auth

2. アプリがテストモードの場合、Google Cloud Console で Google アカウントがテストユーザーとして追加されていることを確認します。

3. authenticateAndSaveCredentials関数の OAuth スコープをチェックして、ニーズに合致していることを確認します。

注記

• このサーバーは、Claude AI または他の MCP 互換アシスタントで使用するように設計されています。

• すべての API リクエストは認証された Google アカウントを使用して行われます

• トークンの更新はサーバーによって自動的に処理されます

• 機密性の高い認証情報はtokens.jsonファイルにローカルに保存されます