gogcli-mcp-classroom

gogcli-mcp-classroom

警告

AI が開発したプロジェクトです。 このコードベースは Claude Code によって構築され、現在も積極的に保守されています。使用前に、すべてのコードとツールの権限を確認してください。

gogcli を介して Google Classroom を拡張する MCP サーバーです。認証ツールに加え、コース、名簿、課題、生徒の提出物（採点）、お知らせ、トピック、招待、プロフィールを扱う専用の Classroom ツールが含まれています。

必要条件

• gogcli がインストールされ、認証済みであること
• Node.js 22+

brew install gogcli
gog auth add [email protected] --services classroom

インストール

npm install -g gogcli-mcp-classroom

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "gogcli-classroom": {
      "command": "gogcli-mcp-classroom",
      "env": {
        "GOG_ACCOUNT": "[email protected]"
      }
    }
  }
}

Claude Code

claude mcp add gogcli-classroom -- gogcli-mcp-classroom

専用の Classroom ツール（44 個）

これに加えて、認証ツールが 5 個あります。専用ツールでは一般的な Classroom 操作をカバーしており、一覧にない操作はエスケープハッチから実行します。

名前空間	ツール
コース	gog_classroom_courses_list、_get、_create、_update、_delete、_archive、_unarchive
生徒	gog_classroom_students_list、_get、_add、_remove
教師	gog_classroom_teachers_list、_get、_add、_remove
名簿	gog_classroom_roster（生徒と教師をまとめて表示）
課題	gog_classroom_coursework_list、_get、_create、_update、_delete
提出物	gog_classroom_submissions_list、_get、_grade、_return、_turn_in、_reclaim
お知らせ	gog_classroom_announcements_list、_get、_create、_update、_delete
トピック	gog_classroom_topics_list、_get、_create、_update、_delete
招待	gog_classroom_invitations_list、_get、_create、_accept、_delete
プロフィール	gog_classroom_profile_get

エスケープハッチ

gog_classroom_run は、次のような上記の専用ツールでカバーされていない Classroom のサブコマンドを実行します。

• guardians（一覧表示／取得／削除）
• guardian-invitations（作成／一覧表示／キャンセル）
• materials（コースの教材）
• coursework assignees（個別の課題対象者の指定）
• announcement assignees（個別のお知らせ対象者の指定）

ユーザーに確認せずに生徒に影響を与える操作は拒否されます。たとえば、お知らせ、課題、教材の公開（--state=PUBLISHED または --scheduled）、より多くの生徒へのアイテムの割り当て（--mode=ALL_STUDENTS または --add-student）、名簿への追加、提出物の返却、保護者の招待が該当します。専用ツールを使用するか、ユーザーに Classroom から操作してもらってください。

例：{ "subcommand": "guardians", "args": ["list", "<studentUserId>"] }。

ライセンス

MIT