Google Classroom MCP Server

🚀 谷歌课堂 MCP サーバー

このサーバーは、Google Classroom のデータにアクセスできる MCP（モデルコンテキストプロトコル）サーバーです。Claude やその他の MCP プロトコルをサポートする AI アシスタントからのアクセスをサポートしています。

🚀 クイックスタート

✨ 主な機能

• Google Classroom のデータにアクセスできる MCP サーバーを提供します。
• Claude やその他の MCP プロトコルをサポートする AI アシスタントと連携可能です。
• Google Classroom とのやり取りに必要な複数のツールを提供します。

📦 インストール

前提条件

• 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 がこのサーバーを使用するように、%APPDATA%\Claude\ 内の claude_desktop_config.json ファイルを更新します。

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

💻 使用例

基本的な使用法

このサーバーは、Google Classroom とのやり取りに必要な複数のツールを提供しています。

1. courses - すべての Google Classroom コースをリストする

'courses' ツールを使用して、すべての Google Classroom コースのリストを取得します。

2. course-details - 特定のコースの詳細情報を取得する

'course-details' ツールを使用し、courseId パラメータを指定することで、特定のコースの詳細情報とお知らせを取得します。

パラメータ:

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

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

'assignments' ツールを使用し、courseId パラメータを指定することで、特定のコースの課題と提出状況を取得します。

パラメータ:

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

高度な使用法

Claude へのサンプルプロンプト例です。

1. すべての Google Classroom コースを表示する
2. Math コース（ID 123456789）の詳細情報を取得する
3. Physics コースの課題の締め切り日を表示する

🔧 技術詳細

権限

• すべてのコースを読み取る: 作成または参加しているすべてのコースにアクセスできます。
• 書き込み権限: コース内でコンテンツを公開および管理できます。

サンプル:

{
  "permissions": {
    "read": ["courses"],
    "write": ["courses"]
  }
}

トラブルシューティング

1. 環境変数が正しく設定されていることを確認してください。
2. ネットワーク接続を確認し、Google Classroom API にアクセスできることを確認してください。
3. 依然として問題が発生する場合は、認証フローを再度実行してください。

node index.js auth

この MCP サーバーは、Google Classroom とのやり取りに強力で柔軟なツールを提供します。