gogcli-mcp-classroom

Name: gogcli-mcp-classroom
Author: chrischall

本地服务

github.com/chrischall科研与教育14 天前更新

代码仓库

关于 gogcli-mcp-classroom

gogcli-mcp-classroom 是通过 gogcli 操作 Google Classroom 的 MCP 服务，适用于管理课程和课堂活动的用户。它为常见操作提供专用工具，也支持运行其他命令，并对影响学生的操作设有限制。

主要功能

01管理课程和班级名册
02创建和编辑课程作业
03列出、评分并退回提交
04管理公告、主题和邀请
05运行其他 Classroom 命令
06限制影响学生的操作

适用场景

01查看课程名册和作业
02为学生提交评分并退回
03管理课程公告和邀请

MCP 相关

它将由 gogcli 支持的 Google Classroom 和身份验证操作作为 MCP 工具提供。专用工具覆盖常见任务，其他子命令可通过扩展入口运行；部分影响学生的操作会被限制或保护。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "chrischall-gogcli-mcp-classroom": {
      "command": "npx",
      "args": [
        "-y",
        "gogcli-mcp-classroom"
      ],
      "env": {
        "GOG_ACCOUNT": "<GOG_ACCOUNT>",
        "GOG_PATH": "<GOG_PATH>",
        "DISPLAY_TZ": "<DISPLAY_TZ>",
        "GOG_READONLY": "<GOG_READONLY>",
        "GOG_TIMEZONE": "<GOG_TIMEZONE>"
      }
    }
  }
}

启动命令npx -y gogcli-mcp-classroom

需要配置的环境变量

GOG_ACCOUNTEmail address of the Google account to use (matches gogcli auth)

GOG_PATHOverride path to the gogcli binary (auto-discovered otherwise)

DISPLAY_TZzone for *Display fields and for interpreting naive gog values; defaults to America/New_York

GOG_READONLYblock all mutating gog API requests (injects gog's --readonly); set to 0/false/no/off (or unset) to allow writes

GOG_TIMEZONEzone gog formats naive dates in; unset, runner.ts hands gog DISPLAY_TZ so the two cannot diverge

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmgogcli-mcp-classroom4.8.1stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

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