课堂助手 praisethefacts/dsh-plugin-google-classroom

dsh-google-classroom

给 DeepSeek Harness 用的 Google Classroom 工具，由 google-classroom-mcp 服务端提供。安装完成后，模型就能看到只读工具，例如 mcp__google-classroom__list_courses 和 mcp__google-classroom__list_due_soon。

这是一个纯配置的 DSH 包：一个 package.json，里面带 dsh.bundle.patch，再加一个 cordis.patch.yml，插入一行 @deepseek-ai/dsh-mcp-client。它不含任何 Host 或 Client 代码。

前置条件

1. Classroom API 的 Google OAuth 客户端。 按 Google Classroom MCP — Setup 的第 1–3 步操作：创建 OAuth 桌面客户端，保存为 ~/.google-classroom-mcp/client_secret.json，然后跑一次登录（uvx --from git+https://github.com/praisethefacts/google-classroom-mcp@v0.1.0 google-classroom-mcp-auth）。
2. uv（提供 uvx）。从 astral.sh/uv 安装，或者 pip install uv。这个包用 uvx 按需拉取并运行服务端，所以不需要单独 pip install。

安装

在 DeepSeek Harness 里打开侧边栏的 Plugins，输入下面任意一个 spec，最后点 Enable now：

- github:praisethefacts/dsh-plugin-google-classroom —— 直接从 GitHub 拉取
- 这个目录的绝对路径，前提是你已经克隆下来

或者在终端里执行：

dsh plugin --profile <profile> add github:praisethefacts/dsh-plugin-google-classroom

把 <profile> 换成你的配置档名称（比如 web 或 desktop）。

验证

问模型一句 "What do I have due this week?" 之类的话，或者直接调用 mcp__google-classroom__list_courses。第一次调用工具可能比较慢，因为 uvx 要下载服务端和它的依赖；之后的调用就快了。

如果每次调用工具都返回 No valid Google credentials found...，说明那次性登录还没跑 —— 看前置条件。Google API 报错提到 scopes，说明 OAuth 同意屏幕没有授权只读的 Classroom scopes；删掉 ~/.google-classroom-mcp/token.json，重新登录。

配置

默认那行执行的是：

uvx --from git+https://github.com/praisethefacts/google-classroom-mcp@v0.1.0 google-classroom-mcp

想改用预装或本地克隆的服务端，就在安装前编辑 cordis.patch.yml，改掉 command/args：

- insert:
- id: mcp-google-classroom
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: google-classroom
transport: stdio
command: google-classroom-mcp

DSH 在启动 stdio 子进程之前，会清掉名字看起来像凭据的环境变量（KEY、PASSWORD、SECRET、TOKEN），所以这个包只依赖 ~/.google-classroom-mcp/ 下的 token 文件，从不依赖环境变量。

工具

所有工具都是只读的：

| Tool | Returns |
| list_courses | 你教的或你上的课程 |
| get_course | 单门课程，含简介与选课代码 |
| list_coursework | 作业、测验、题目和资料，带截止日期 |
| list_due_soon | 所有进行中课程的即将到期作业 |
| list_announcements | 某门课程最近的公告 |
| list_teachers / list_students | 名单（姓名、邮箱） |
| list_submissions | 某份作业的提交状态与成绩 |

开发

npm install
npm test

测试会解析 cordis.patch.yml，并在不启动 harness 的情况下检查 bundle 声明。

许可证

MIT