南理工教务 MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
简体中文 | English
南理工教务 MCP
把南京理工大学教务系统接进任何支持 MCP 的 AI 客户端——课表、成绩、考试、学籍、培养方案、空闲教室,一句中文就能问出来,不用开浏览器、不用每次输密码。
装上之后,能这样问
你说 | 它做的事 |
「我这周有哪些课」 | 拉本学期课表,按星期分组列出节次、教室、教师 |
「下周一下午的课还在吗」 | 按周次筛选,只回那一门 |
「我这学期多少学分」 | 读培养方案执行计划,逐学期给出课程清单与学分小计 |
「高数考了多少分」 | 查成绩,支持按学期、课程名过滤 |
「下周三下午哪有空教室」 | 查全校教室占用,返回该时段空闲的教室 |
「我期末考试在哪考」 | 查考试安排:时间、考场、座位号 |
课表返回的样子(省略部分):
周三:
01-05 现代模型加工技术 [13周] 江阴格物A308
周一:
04-05 人工智能导论 [13,14,15,16周] 江阴致真A114
06-10 现代模型加工技术 [14周] 江阴格物A308培养方案返回的样子:
{
"totalCourses": 91,
"totalCredits": 191.5,
"terms": [
{ "semester": "2026-2027-1", "count": 14, "credits": 26.3 },
{ "semester": "2026-2027-2", "count": 20, "credits": 42.8 }
],
"emptyTerms": ["2026-2027-3"]
}Related MCP server: TPCU MCP Server
不需要浏览器,也不用反复输密码
学校的统一身份认证每次登录都要一个动态 salt,密码还得在浏览器里加密。这个项目把那一整套搬到了命令行:
从登录页取出
pwdEncryptSalt,用AES-128-CBC在本地加密「64 位随机串 + 密码」;换到 CAS 的
CASTGC(勾了 30 天免登录);再经教务的
indexsso.jsp换成教务会话。
全程纯 HTTP,约 3–4 秒,没有验证码。会话过期时工具会自己重建,你只会看到一次多等两秒。
安装
依赖:Node.js 18+、python3(macOS 自带)、openssl(系统自带)。
git clone https://github.com/DrivingGodJ/njust-jw-mcp.git
cd njust-jw-mcp写一份凭据(只存在你本机,权限 600):
mkdir -p ~/.config/njust
cat > ~/.config/njust/credential.json <<'EOF'
{ "studentNo": "你的学号", "password": "统一身份认证密码" }
EOF
chmod 600 ~/.config/njust/credential.json在客户端里注册(以 ~/.workbuddy/mcp.json 为例,Claude Desktop 用 claude_desktop_config.json,字段同为 mcpServers):
{
"mcpServers": {
"njust-jw": {
"command": "node",
"args": ["/绝对路径/njust-jw-mcp/index.mjs"]
}
}
}注册后重开客户端,问一句「我这周有什么课」就能验证。
可选环境变量:NJUST_JW_SCRIPTS(覆盖脚本目录)、NJUST_PYTHON(指定 python 解释器)。
工具一览
工具 | 作用 |
| 本学期课表,可按周次筛选,输出文本或 JSON |
| 课程成绩,可按学期、课程名过滤 |
| 考试安排:场次、时间、考场、座位号 |
| 学籍卡片(身份证、考号按首尾打码) |
| 培养方案 / 执行计划,逐学期课程与学分 |
| 全校教室占用,可查某天某时段空闲教室 |
| 当前账号可用的功能菜单,接新功能前先看它 |
| 通用站内页面抓取,返回标题、表格、链接、正文 |
| 重建登录态(自动登录失败才回退浏览器) |
一些边界
非官方项目。用的是教务系统面向学生的公开页面与接口,学校升级可能让它失效,届时需要跟着改。
只在你本机运行。数据不经过任何服务器,也不会被上传;MCP 服务器只做「取回并结构化」。
凭据是明文的。
credential.json权限 600,但内容没加密。介意的话把它放进钥匙串或磁盘加密卷,再加个开机解锁的包装脚本。只用自己的账号。别借给别人跑,学校侧看到的是同一个会话。
身份证号、准考证号在
jw_profile里已做打码处理,但这只是减少误展示,不改变数据本身在你本机的性质。
进一步了解
MIT License。校内系统的接口细节随学校版本变化,欢迎提 issue 补充你遇到的差异。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Connect Claude, Cursor or any MCP client to your GymUp training data.
Unofficial NTNU course data: search, timetables, grades, course info, and exam logistics.
Read-only access to Epivo's live course catalogue for AI agents.
Related MCP Servers
- -licenseCqualityNot gradedmaintenanceEnables AI assistants to interact with Hangzhou Dianzi University's academic system through automatic login and course schedule retrieval. Supports secure authentication and structured academic data access for HDU students.2-
- AlicenseNot gradedqualityCmaintenanceEnables AI applications supporting MCP to log into a university academic affairs system and query schedules, absences, grades, and leave records through natural-language conversation. It also lets users submit or withdraw leave requests and plan and save monthly work-study attendance, with built-in confirmation cues for destructive actions.1MIT
- 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 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