STU MCP
STU MCP lets an agent query cached campus notices, courses, grades, exams, tasks, resources, schedules, and service links, plus manage local setup, task status, and student profile data.
Check available campus features, source login states, and cache times.
Open a local setup page for official school logins without handling passwords/tokens.
Refresh cached public, OA, academic, MySTU, and Yuketang sources with configurable limits.
Search local notice caches and read notice bodies, attachment lists, and cached PDF/text attachments.
Read grades, compute cached academic summaries, and read exam arrangements.
Read MySTU/Yuketang courses, assignments/tasks, course resources, and personal schedules.
Query public school service entry links.
Mark local tasks as todo/done/ignored without changing school records.
Save optional college, major, entry year, and interests for agent filtering.
Allows reading cached Moodle/ELC activity links and course resources via MySTU, without submitting assignments or modifying school records.
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., "@STU MCP 看看最近的 OA 通知,找出竞赛和报名截止时间,读原文确认资格"
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.
STU MCP
这个项目的前身,是我在「养」Hermes agent 时,从零搭起来的一个自用信息聚合器。学校通知、课程、作业,散在不同地方的信息,我都想慢慢接进去。自己用的版本里,甚至还接入了微信聊天记录。
我折腾它的原因,是希望 agent 在帮我做事时,能拿到足够的个人上下文:我最近在忙什么、有什么通知要看、哪些事情还没做完。和我有关的信息,如果它能在需要时自己查到,我就能少重复一些背景,也不用总在几个网站和聊天窗口之间来回复制粘贴。
后来,我把里面和汕大有关的部分整理成了 STU MCP,想让其他同学也能接到自己常用的 agent 上。它负责找信息、读信息,怎么理解和整理,交给你自己的 agent。
微信聊天记录接入留在自用版本里,公开版不包含。用这里的功能也不需要先装 Hermes,或者另外配一份模型 API key。
想试试的话
找一个能在你电脑上执行命令的 agent,把这两行发给它:
帮我安装 STU MCP:https://github.com/0error0warning/stu-mcp
按 docs/install.md 接入当前客户端,保留已有配置并验证公开查询。按安装版本说明登录;认证信息由我本人输入,不发给 agent。装好以后,可以直接问它:
“最近有什么适合我报名的竞赛?把截止时间和原文找出来。”
“整理一下 MySTU 接下来两周的作业,按截止时间排一排。”
“树洞里有人聊过这门选修课吗?搜一下大家怎么说。”
Related MCP server: CAU e-Class MCP
现在能查些什么
功能分类 | 来源与系统 | 当前接入范围 | 登录方式 |
通知与活动 | 学校官网、学生处、OA 公告 | 新闻、通知、活动、正文、附件列表及 PDF / 文本附件内容 | OA 原站可达且内容公开时免登录;WebVPN 访问通道按需,见读取范围与条件 |
课程与教务 | 教务、MySTU / Moodle、雨课堂、对分易 | 成绩、考试、本人理论课表、课程、作业、资料、个人日程;对分易课程监听、启停及签到结果,新课堂提交仍待实测 | 教务与 MySTU 使用学校 SSO;雨课堂手机确认二维码;对分易原微信回调,各自保存会话 |
医学院课表(试验) | 医学院教务 | 本人当前学期课表;适配器通过合成测试,待真实账号验收,见范围说明 | 教务本地口令及本人填写图片验证码,独立保存会话 |
校园办事 | 宿舍报修、综合报修、一网通办等 | 桑浦山宿舍 | 宿舍报修使用学校 SSO,单独保存会话;其他入口按原站要求 |
一卡通本人查询 | 学校一卡通系统 | 卡余额和状态、指定日期及类型的历史流水;不挂失、充值或改密 | 独立查询密码和本人填写的图片验证码;官方入口为明文 HTTP |
网络访问与排障 | 登记的学校入口及认证依赖 | 单服务连接诊断、学校入口批量检测:检查 DNS、匿名直连,按需对照代理或公共 DNS | 免登录;不改变网络设置,不代表业务已可用 |
第三方校园生活与社区 | 充电平台、STU 外卖(开发中)、狐友 | 设备与插座状态、外卖目录 / 配送批次 / 选餐、树洞公开帖子及评论;外卖不下单或支付 | 充电和公开讨论免登录;外卖需单独配置 |
软件与本地管理 | stu-mcp 宿主及本地数据 | 安装接入、登录配置、更新检查与升级、本地待办和个人偏好 | 按需配置 |
选择登录配置时,可先看配置哪些登录,当前能用哪些功能:学校统一账号对应已适配的教务、MySTU 和宿舍报修;雨课堂、对分易、WebVPN 及第三方配置各有自己的功能范围,公开内容按条件免登录。同目录另列学校服务的入口和未接入项,不将“学校有这个系统”算成“MCP 已能使用”。
设置页、stu-mcp status 和 MCP get_capabilities 使用同一份功能目录,告诉你配置后能做什么、哪些服务还没接入。学校统一账号输入一次,分别连接已接入的教务、MySTU 和宿舍报修;各业务仍独立保存会话,某项未完成会单独说明。
也可以记一下本地待办,或者告诉 agent 你的学院、专业和兴趣。它们都不是必填项,本地勾选“完成”也不会替你向学校提交作业。
查到的信息会带来源和缓存时间。想看最新消息时,让 agent 先刷新;没查到也可能只是这次没取全。狐友里是同学们的讨论,学校的正式要求还是要看 OA 或学校原文。狐友怎么查
本版包含充电查询,由本机 MCP 直接请求充电平台,按设备缓存,没有网站或自建服务器依赖。现有清单包含 15 台已核验设备,不代表全校完整清单;离线和旧数据会单独标记。充电查询用法
校园连接按服务处理:r和一网通办先查自身入口,宿舍报修需要时核实校园接入,SSO和ITS各协议独立判断。同属网络排障的两个工具保留各自范围:单服务诊断定位一个入口及其依赖,批量检测比较固定目录;校园入口普查并不会自动扩充运行时探测清单。普通读取复用连接,同批次暂时跳过连接失败的主机,继续读取其他来源,不自动改代理或接入远程隧道。单服务诊断 · 批量检测
自己动手安装
先装好 uv,然后运行。这里以 Codex 为例:
uv tool install --python 3.12 https://github.com/0error0warning/stu-mcp/releases/download/v0.7.6/stu_mcp-0.7.6-py3-none-any.whl
stu-mcp connect codex --apply第二行换成你用的客户端,比如 claude-code 或 cursor。其他客户端、豆包工作和 Skill 的接法放在这里。v0.6.1 起,运行 stu-mcp update 即可检查并升级;只想看有无新版用 stu-mcp update --check,也可以让 agent 调用对应更新工具。升级后,本机 stdio 重新加载 MCP;私有 HTTP 须重启宿主 MCP 服务。旧版首次升级见安装说明,支持范围见更新说明。
使用 DeepSeek Harness(DSH)时,可另装 STU MCP 插件,在左右侧栏查看账号状态、打开登录设置。校园查询照常在对话里完成,安装方法见 DSH 说明。
MCP 接入和技能安装分别处理。随包的课表导出技能组织校历核对和文件转换。v0.7.1 加入教务本人理论课表读取,继续复用该技能和同一转换器;实验课、校历及作息另行核对。技能 ZIP 是可选资源包,生成后仍需按客户端支持的方式安装,不会自动让当前 agent 加载技能。
需要登录时,让 agent 打开设置页,或自己运行 stu-mcp setup。在自己的浏览器里配置学校统一账号、雨课堂、对分易、WebVPN 或一卡通,认证信息不经过 agent。WebVPN 可填写已有令牌密钥,由程序生成动态码并自动登录;不配置密钥也能手动输入当前动态码。喜欢终端可用 stu-mcp login school 等命令,完整用法见认证说明。
本机 stdio 与个人服务器私有 Streamable HTTP 共用一套工具。CLI 与设置页共用 HTTP 认证核心,默认安装和 Docker 模板不需要桌面或 Chromium;无桌面服务器可以完整使用 CLI。会话及个人缓存加密保存,普通学校密码只用于本次认证。客户端到 MCP 和 MCP 到学校是两段网络,连上服务器不代表服务器能访问校园网。服务器说明 · 存储与隐私
本版包含对分易后台和轻量本地网页:选课、启停监听、查询签到结果,微信回调可在宿主终端或本地网页完成。MCP 退出后后台继续运行,状态明确区分未启动、未登录、已暂停、监听中和查询异常。支持持续监听;电脑需保持运行和联网。新的课堂自动提交仍待实测。安装与用法
宿舍报修使用独立 HTTP 会话填表,完整展示实际表单,等你明确确认后只提交一次。随后核对新增单据及详情,返回单号、处理状态和核对时间;结果未知时只读查单。草稿留在进程内存,登录会话独立加密保存。当前适配桑浦山学生社区;新版真实登录和填表预览已核验,正式提交仍由合成与回环测试覆盖,没有为验收额外建单。校园网报修是另一套入口。使用与验证范围
喜欢用终端的话,也可以直接查:
stu-mcp refresh oa --limit 20
stu-mcp query notice --source oa --search 竞赛
stu-mcp huyou search 选课还在慢慢补
当前版本为 v0.7.6 学生预览版,发布状态以 GitHub 发行页为准。发行说明 · 最近更新
正式 HTTP 适配器已实测教务、MySTU 的身份与课程、ELC/Campus 的部分业务、雨课堂课程活动,以及报修登录和完整预览。WebVPN 的密码、动态口令和资源目录通过;受保护 OA 正文及自然过期续登尚未通过本轮验收。发行 CI 包含跨平台测试和默认镜像离线检查,容器内学校业务、跨机接入、更多账号和真实新报修提交仍分别待验,详见验证记录。
如果你用起来了,或者发现某个入口读不动了,欢迎开 issue 聊聊。告诉我用的版本、卡在哪一步就很有帮助,别把真实成绩、密码或登录凭据贴进去。
想自己改也可以:
uv sync --extra dev
uv run --extra dev pytest -q
uv run --extra dev ruff check .
uv run stu-mcp setup
uv run stu-checkin
uv buildMIT 许可。个人折腾的小项目,和学校官方没有关系。
Available Tools
16 toolsacademic_summaryBRead-onlyIdempotent
按已缓存的全部成绩计算学分加权均分/绩点;包含计算口径,不替代学校官方认定。
Inputs: semester. Returns: object
get_capabilitiesARead-onlyIdempotent
查看可用校园功能、每个来源的登录状态和缓存时间;不会要求一次配置全部账号。
Inputs: no named parameters. Returns: object
get_course_resourcesARead-onlyIdempotent
查询课程资料、Moodle/ELC 活动链接缓存。工具不会提交作业或修改学校记录。
Inputs: limit, query, offset, source. Returns: object
get_coursesBRead-onlyIdempotent
读取 MySTU/雨课堂课程缓存;各来源独立登录,使用最新可用学期。
Inputs: limit, query, offset, source. Returns: object
get_examsBRead-onlyIdempotent
读取本人考试安排缓存,包含考场/时间等信息;以学校页面为准。
Inputs: limit, query, offset. Returns: object
get_gradesARead-onlyIdempotent
读取本人教务成绩缓存,支持课程/学期关键词。需要先在本地登录并刷新 jw。
Inputs: limit, query, offset. Returns: object
get_noticeB
读取通知正文及附件列表;refresh=true 从已缓存的学校链接获取正文,不接受任意 URL。
Inputs: item_id (required), refresh. Returns: object
get_scheduleBRead-onlyIdempotent
读取 MySTU 个人日程缓存,刷新范围为过去 7 天至未来 31 天。
Inputs: limit, query, offset. Returns: object
get_service_linksCRead-onlyIdempotent
查询学校公开服务入口,不需要登录。
Inputs: limit, query, offset. Returns: object
get_tasksCRead-onlyIdempotent
读取作业/测验待办、截止时间和学校提供的提交状态;本地状态与学校状态分开。
Inputs: limit, query, offset, source. Returns: object
open_setupA
在用户本机打开设置页,用学校官方页面完成登录。不要向用户索要密码或 token。
Inputs: no named parameters. Returns: object
read_attachmentBRead-onlyIdempotent
提取已缓存通知的 PDF/文本附件,序号从 0 开始。最多 8 MiB、100 页,扫描件不做 OCR。
Inputs: item_id (required), index. Returns: object
refresh_sourceA
按需获取 public/oa/jw/mystu/yuketang;1–50 条/课程,报告范围和部分失败。教务学期可留空。
Inputs: source (required), limit, semester. Returns: object
search_noticesARead-onlyIdempotent
搜索本地通知缓存;空结果不能证明学校没有通知。先根据范围刷新,再读正文确认条件。
Inputs: limit, query, offset, source. Returns: object
set_student_profileB
保存可选的学院/专业/年级/兴趣,帮助用户的 agent 筛选机会。不接收认证信息。
Inputs: major, college, interests, entry_year. Returns: object
set_task_statusA
将本地待办标记为 todo/done/ignored。仅改本机状态,不向学校提交或修改作业。
Inputs: status (required), item_id (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Each tool targets a distinct campus resource or local action: refresh_source handles cache population, get_* tools read specific cached domains, and set_* tools change local state. The only potential overlap is refresh_source versus get_* refresh behavior, but the descriptions make the cache-refresh/read split clear.
All tools use snake_case and are mostly verb_noun, such as refresh_source, get_notice, and set_task_status. The lone exception is academic_summary, a noun phrase, but it remains readable and does not undermine the overall pattern.
16 tools is slightly above the typical 3-15 sweet spot, but the broad campus aggregation purpose justifies coverage across notices, grades, courses, tasks, schedule, setup, and local state. No tool appears redundant.
The surface covers the major lifecycle needs: source refresh, notice search/read/attachment extraction, grades/GPA, exams, courses/resources, tasks, schedule, service links, profile, capabilities, and setup. Minor gaps like no explicit get_profile or cache-clear exist but are workable.
Maintenance
Related MCP Connectors
Web data for agents: YouTube transcripts, screenshots, Google News, WHOIS, jobs, tech stack, more.
Proxy-rotated web scraping and cross-platform intelligence for AI agents.
Scrape, map, crawl, search and monitor the web. Runs locally with no API key, cites every source.
Web search, page-to-markdown, memory, leases and proof for agents. x402, no signup.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables AI agents to access Kwangwoon University's KLAS academic system for course schedules, deadlines, attendance, lecture materials, assignments, and adaptive study tools while keeping credentials and data local.31MIT
- FlicenseNot gradedqualityBmaintenanceEnables agents to query course information, announcements, assignments, and deadlines, and to download attachments, syllabus PDFs, and lecture videos through a local browser connection. It can also prepare assignment submissions for review without uploading by default.2-
- AlicenseAqualityBmaintenanceRuns locally and lets AI clients read course deadlines, courses, announcements, activities, and files through a user-authenticated browser session, with assignment submission optional.6MIT
- AlicenseBqualityBmaintenanceEnables AI clients to access a student's class schedule, empty classroom availability, campus card balance, extracurricular activities, library seats, and e-station guides, while keeping credentials local and requiring explicit confirmation for bookings and registrations.25MIT