Skip to main content
Glama

@powercess/yuketang-mcp

雨课堂(Yuketang / 雨课堂)MCP 服务器:把雨课堂网页端的能力封装成 AI 可直接调用的工具。

扫码登录一次,即可让 AI 助手读取课程、课件、课堂回顾、AI 思维导图、回放时间线与作业进度。

能做什么

工具

能力

ykt_login

扫码登录(二维码直接在对话里显示)

ykt_status

检查会话有效性,确认登录的是哪个账号

ykt_logout

清除本地会话

ykt_courses

课程列表(按学期分组)

ykt_classroom

课程班级详情

ykt_activities

课程活动时间轴(上课记录 / 作业 / 公告)

ykt_lesson

课时详情与课件清单

ykt_slides

课件全量幻灯片 + 图片地址

ykt_lesson_summary

课堂概览(课件、签到状态)

ykt_replay_timeline

回放时间线,含老师每次翻页

ykt_mind_map

AI 生成的课堂思维导图

ykt_notes

课堂笔记目录与正文

ykt_score

学情分数构成

ykt_course_progress

章节树 + 完成度 + 分数 + 截止时间

ykt_live

正在上课 / 待开始考试

ykt_discussion

课程公告与讨论区

全部为只读操作。 签到、答题、发弹幕等会产生副作用的行为不在此实现——那等于代替你本人操作。

Related MCP server: campus-edu-mcp

安装

需要 Node ≥ 23.4 或 Bun ≥ 1.x。

npm install -g @powercess/yuketang-mcp
yuketang-mcp

本地开发:

npm install && npm run build   # Node
bun run dev                    # Bun,直接运行 TypeScript,无需构建

接入 MCP 客户端

{
  "mcpServers": {
    "yuketang": {
      "command": "npx",
      "args": ["-y", "@powercess/yuketang-mcp"]
    }
  }
}

登录

雨课堂分四个区域,会话互不通用,登录时必须选对:

region

名称

standard

雨课堂(默认)

hetang

荷塘雨课堂

changjiang

长江雨课堂

huanghe

黄河雨课堂

调用 ykt_login 会返回二维码,用微信或雨课堂 App 扫码确认即可。二维码有效期约 5 分钟。

也可以跳过扫码,用环境变量直接提供会话:

YKT_REGION=standard YKT_SESSIONID=<your-sessionid> yuketang-mcp

会话保存在 ~/.yuketang-mcp/(目录 0700、文件 0600),只存 sessionid,不存姓名或学号。

配置

环境变量

说明

YKT_REGION

区域,配合 YKT_SESSIONID 使用

YKT_SESSIONID

直接提供会话,跳过扫码

YKT_STATE_DIR

会话保存目录,默认 ~/.yuketang-mcp/

使用提示

  • 课件图片无需鉴权:ykt_slides 返回的图片地址可直接 HTTP 下载,不需要 Cookie。

  • 判断「哪些页讲过」用回放时间线:课件接口的 visible 字段恒为 true,没有区分度;ykt_replay_timeline 的 shownSlideIndexes 才是实际展示过的页。

  • 章节数据用 ykt_course_progress:它含完成度、分数与截止时间,比抽象的章节树更适合直接消费。

  • 活动分页:offset 是每页条数而非跳过条数,page 从 0 开始。

已知边界

  • 雨课堂没有公开 API,本服务使用学生端接口。平台改版可能失效。

  • 进入课堂实时内容需要先签到换取课堂令牌。本服务不代签到,因此只提供只读概览。

  • 已完成的作业无法读取题面(平台返回无权限)。

  • 未实现的能力:位置签到、动态二维码签到、考试作答、讨论发帖。

License

MIT

Available Tools

16 tools
ykt_activities课程活动时间轴A

列出某课程的活动(上课记录、作业、公告)。type 含义:5=试卷作业,9=公告,14=上课记录,19=章节作业。上课记录的 coursewareId 即 lessonId,用于查课件。

Inputs: classroomId (required), page, size, region.

ykt_classroom课程班级详情C

某课程班级的详细信息:课程名、教师、学校 ID、班级起止时间。

Inputs: classroomId (required), region.

ykt_course_progress课程章节与进度B

获取课程完整章节树,含每个叶子的类型、完成度、分数与截止时间。leafType 含义:0=视频,3=推荐,4=讨论,5=考试/作业,6=作业,8=签到/课堂,19=章节作业。

Inputs: courseId (required), classroomId (required), region.

ykt_courses课程列表B

列出所有课程(按学期分组)。classroomId 是后续查活动、章节、公告的入口;courseId 用于查章节进度。

Inputs: term, region.

ykt_discussion讨论区与公告C

读取课程公告或讨论区帖子列表。

Inputs: classroomId (required), kind, limit, offset, +1 more.

ykt_lesson课时详情B

查询一次课堂的元信息与课件清单。presentationIds 是数组,一次课可能有多份课件。

Inputs: lessonId (required), region.

ykt_lesson_summary课堂小结B

课堂概览:课件清单、签到状态、课堂标题。用于快速了解一次课的构成。

Inputs: lessonId (required), region.

ykt_live正在上课 / 待考试A

列出当前正在进行的课堂和即将开始的考试。进入课堂实时内容需要先签到换取课堂令牌,本服务不代签到,因此只提供只读概览。

Inputs: region.

ykt_login雨课堂扫码登录A

获取二维码并等待扫码确认。二维码以文本形式返回(可直接在终端显示),同时给出图片文件路径。四个区域(standard/hetang/changjiang/huanghe)的会话互不通用,请选择账号实际所在的区域。

Inputs: region, timeoutSeconds.

ykt_logout退出登录A

删除本地保存的会话。不会影响其他设备上的登录状态。

Inputs: region (required).

ykt_mind_mapAI 课堂思维导图C

获取平台为这节课自动生成的思维导图(树形结构,含层级)。

Inputs: lessonId (required), region.

ykt_notes课堂笔记A

列出课堂笔记;提供 liveId 时返回该笔记的正文。先用不带 liveId 的调用拿目录,再按需取正文。

Inputs: lessonId (required), liveId, region.

ykt_replay_timeline回放时间线A

获取课堂回放的完整事件序列,包括老师每次翻页的页码与时间。shownSlideIndexes 是实际展示过的页,这是判断「哪些页讲过」的唯一可靠途径。

Inputs: lessonId (required), region, includeEvents.

ykt_score学情分数C

某次课的得分构成:签到、课堂题、测验各占比例与得分。

Inputs: lessonId (required), region.

ykt_slides课件幻灯片B

获取一份课件的全部页面。返回页码与图片地址;图片可直接 HTTP 下载,无需 Cookie 或鉴权参数。题目字段通常为 null(课后不返回题目内容)。

Inputs: lessonId (required), presentationId (required), region, withProblem.

ykt_status登录状态B

检查各区域已保存的会话是否仍然有效,返回账号名用于确认登录的是哪个账号。

Inputs: region.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have a clearly distinct target: session management vs. course listings vs. per-lesson artifacts (slides, replay, mind map, notes, score). However, ykt_lesson and ykt_lesson_summary overlap substantially (both return the courseware list for a lesson), and announcements can be reached through both ykt_activities (type=9) and ykt_discussion, forcing the agent to guess. These few overlaps are mitigated by descriptions that hint at the intended use, but boundaries are not airtight.

    Naming Consistency4/5

    All 16 tools share a uniform `ykt_` prefix and snake_case body, so the set reads predictably. The bodies are noun-oriented (ykt_courses, ykt_slides, ykt_score) rather than the verb_noun pattern, with a handful of verb-style names (ykt_login, ykt_logout), but there are no mixed casing conventions or erratic verb styles.

    Tool Count4/5

    16 tools is on the high side but each maps to a genuine artifact of the learning platform (session, courses, activities, lessons, slides, replay, mind map, notes, score, progress, live, discussion, classroom). The only clearly redundant slot is ykt_lesson_summary, which largely restates ykt_lesson. Scope is otherwise defensible for a domain this rich.

    Completeness4/5

    Within the declared read-only scope, coverage is strong: auth lifecycle (login/status/logout), course discovery, activity enumeration, per-lesson resources, progress tree, and live overview. Dead ends exist — quiz/question content is explicitly null from ykt_slides, and there is no write path (no sign-in, no homework submission), which is a deliberate limitation but limits the surface for an agent trying to complete coursework.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to read a student's own university academic data — class timetables, exam schedules, grades, available terms, and empty classrooms — from Qiangzhi (jsxsd) or Zhengfang V9 systems via a session imported from the browser. All access is strictly read-only, never performing course selection, withdrawal, or evaluations.
      6
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables an AI assistant to read course and lesson data, transcripts, PDF handouts, and progress from a digital university account, with study prompts and local resource sync. It is read-only by design, so it cannot alter attendance, completed lessons, or tests.
      12
      MIT