yuketang-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YKT_REGION | No | Region for the Yuketang session, used together with YKT_SESSIONID (e.g. standard, hetang, changjiang, huanghe). | |
| YKT_SESSIONID | No | Provide the session directly to skip QR-code login. Used together with YKT_REGION. | |
| YKT_STATE_DIR | No | Directory where the session is saved. | ~/.yuketang-mcp/ |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ykt_loginA | 获取二维码并等待扫码确认。二维码以文本形式返回(可直接在终端显示),同时给出图片文件路径。四个区域(standard/hetang/changjiang/huanghe)的会话互不通用,请选择账号实际所在的区域。 |
| ykt_statusB | 检查各区域已保存的会话是否仍然有效,返回账号名用于确认登录的是哪个账号。 |
| ykt_logoutA | 删除本地保存的会话。不会影响其他设备上的登录状态。 |
| ykt_coursesB | 列出所有课程(按学期分组)。classroomId 是后续查活动、章节、公告的入口;courseId 用于查章节进度。 |
| ykt_activitiesA | 列出某课程的活动(上课记录、作业、公告)。type 含义:5=试卷作业,9=公告,14=上课记录,19=章节作业。上课记录的 coursewareId 即 lessonId,用于查课件。 |
| ykt_lessonB | 查询一次课堂的元信息与课件清单。presentationIds 是数组,一次课可能有多份课件。 |
| ykt_slidesB | 获取一份课件的全部页面。返回页码与图片地址;图片可直接 HTTP 下载,无需 Cookie 或鉴权参数。题目字段通常为 null(课后不返回题目内容)。 |
| ykt_lesson_summaryB | 课堂概览:课件清单、签到状态、课堂标题。用于快速了解一次课的构成。 |
| ykt_replay_timelineA | 获取课堂回放的完整事件序列,包括老师每次翻页的页码与时间。shownSlideIndexes 是实际展示过的页,这是判断「哪些页讲过」的唯一可靠途径。 |
| ykt_mind_mapC | 获取平台为这节课自动生成的思维导图(树形结构,含层级)。 |
| ykt_notesA | 列出课堂笔记;提供 liveId 时返回该笔记的正文。先用不带 liveId 的调用拿目录,再按需取正文。 |
| ykt_scoreC | 某次课的得分构成:签到、课堂题、测验各占比例与得分。 |
| ykt_course_progressB | 获取课程完整章节树,含每个叶子的类型、完成度、分数与截止时间。leafType 含义:0=视频,3=推荐,4=讨论,5=考试/作业,6=作业,8=签到/课堂,19=章节作业。 |
| ykt_liveA | 列出当前正在进行的课堂和即将开始的考试。进入课堂实时内容需要先签到换取课堂令牌,本服务不代签到,因此只提供只读概览。 |
| ykt_discussionC | 读取课程公告或讨论区帖子列表。 |
| ykt_classroomC | 某课程班级的详细信息:课程名、教师、学校 ID、班级起止时间。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.