yuketang-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yuketang-mcp Scan the QR code to log in to Yuketang, then list my courses."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@powercess/yuketang-mcp
雨课堂(Yuketang / 雨课堂)MCP 服务器:把雨课堂网页端的能力封装成 AI 可直接调用的工具。
扫码登录一次,即可让 AI 助手读取课程、课件、课堂回顾、AI 思维导图、回放时间线与作业进度。
能做什么
工具 | 能力 |
| 扫码登录(二维码直接在对话里显示) |
| 检查会话有效性,确认登录的是哪个账号 |
| 清除本地会话 |
| 课程列表(按学期分组) |
| 课程班级详情 |
| 课程活动时间轴(上课记录 / 作业 / 公告) |
| 课时详情与课件清单 |
| 课件全量幻灯片 + 图片地址 |
| 课堂概览(课件、签到状态) |
| 回放时间线,含老师每次翻页 |
| AI 生成的课堂思维导图 |
| 课堂笔记目录与正文 |
| 学情分数构成 |
| 章节树 + 完成度 + 分数 + 截止时间 |
| 正在上课 / 待开始考试 |
| 课程公告与讨论区 |
全部为只读操作。 签到、答题、发弹幕等会产生副作用的行为不在此实现——那等于代替你本人操作。
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 | 名称 |
| 雨课堂(默认) |
| 荷塘雨课堂 |
| 长江雨课堂 |
| 黄河雨课堂 |
调用 ykt_login 会返回二维码,用微信或雨课堂 App 扫码确认即可。二维码有效期约 5 分钟。
也可以跳过扫码,用环境变量直接提供会话:
YKT_REGION=standard YKT_SESSIONID=<your-sessionid> yuketang-mcp会话保存在 ~/.yuketang-mcp/(目录 0700、文件 0600),只存 sessionid,不存姓名或学号。
配置
环境变量 | 说明 |
| 区域,配合 |
| 直接提供会话,跳过扫码 |
| 会话保存目录,默认 |
使用提示
课件图片无需鉴权:
ykt_slides返回的图片地址可直接 HTTP 下载,不需要 Cookie。判断「哪些页讲过」用回放时间线:课件接口的
visible字段恒为 true,没有区分度;ykt_replay_timeline的shownSlideIndexes才是实际展示过的页。章节数据用
ykt_course_progress:它含完成度、分数与截止时间,比抽象的章节树更适合直接消费。活动分页:
offset是每页条数而非跳过条数,page从 0 开始。
已知边界
雨课堂没有公开 API,本服务使用学生端接口。平台改版可能失效。
进入课堂实时内容需要先签到换取课堂令牌。本服务不代签到,因此只提供只读概览。
已完成的作业无法读取题面(平台返回无权限)。
未实现的能力:位置签到、动态二维码签到、考试作答、讨论发帖。
License
MIT
Available Tools
16 toolsykt_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
Scored across 16 tools
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.
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.
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.
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
Related MCP Connectors
Read-only access to a student's recorded classes: transcripts, notes, slides and concept map.
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
Let AI agents use any website you're logged in to. Sessions stay encrypted on your machine.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to directly query Chaoxing/Xuexitong courses and homework status via fast HTTP calls, with persistent login and automatic re-authentication.15MIT
- AlicenseAqualityBmaintenanceEnables 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.61MIT
- AlicenseAqualityCmaintenanceEnables 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.12MIT
- AlicenseAqualityCmaintenanceEnables AI coding assistants to authenticate with a token, view class schedules and assignments, read course materials, and submit files or links to the academic portal.9MIT