WTS-bupt-unOfficial-mcp
WTS-bupt-unOfficial-mcp
非官方北邮(BUPT)移动教务 MCP(Model Context Protocol)服务:查询今日空教室、课程表,以及两者的联合查询。
服务请求参考并移植自开源项目 where_to_study。
⚠️ 本项目为非官方服务,仅供学习交流,请勿滥用。使用即表示你同意自行承担账号风险。
功能(MCP Tools)
Tool | 说明 |
| 校区信息(西土城 01 / 沙河 04)及主要教学楼 |
| 查询今日空教室,支持按 |
| 查询课程表,默认当前周,支持 |
| 联合查询:今日课程 + 每节次空闲教室数 + 当前节次空闲教室 + 全天空闲教室 |
Related MCP server: mydy-lms
快速开始
1. 克隆与安装
git clone https://github.com/Nemoyuzx/WTS-bupt-unOfficial-mcp.git
cd WTS-bupt-unOfficial-mcp
npm install
npm run build2. 配置环境变量
export BUPT_USER_NO=你的学号
export BUPT_PWD=你的移动教务密码
export BUPT_CAMPUS_ID=01 # 可选,默认 01=西土城;04=沙河
export BUPT_TERM_START_DATE= # 可选,学期开学日 YYYY-MM-DD(无法从接口推断时兜底)3. 直接运行
node dist/index.js4. 接入 Claude Desktop / Cursor 等 MCP 客户端
在 MCP 客户端配置中添加(stdio 方式):
{
"mcpServers": {
"wts-bupt": {
"command": "node",
"args": ["/绝对路径/WTS-bupt-unOfficial-mcp/dist/index.js"],
"env": {
"BUPT_USER_NO": "你的学号",
"BUPT_PWD": "你的密码",
"BUPT_CAMPUS_ID": "01"
}
}
}
}使用示例
问 MCP 客户端:
「查一下今天沙河校区第 3 节有哪些空教室」
「这周我有什么课?」
「现在哪些教室空着?」(联合查询:
get_today_overview)
开发与测试
npm test # 使用 where_to_study 的原始响应样例做解析器单测
npm run build # 编译到 dist/目录结构
src/
├── index.ts # MCP 服务入口(4 个工具)
├── api.ts # 移动教务 HTTP 客户端(登录/课表/空教室)
├── date.ts # 北京时区日期/周次/节次工具
├── parsers/
│ ├── classrooms.ts # 空教室响应解析(移植 SJDClassroomParser)
│ └── schedule.ts # 课表响应解析(移植 SJDScheduleParser + ScheduleLogic)
└── types.ts # 数据模型(Course / Classroom / 节次时刻表)
test/
└── run-tests.ts # 单元测试(含参考项目原始响应样例)License
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceAn MCP server for the Bakaláři v3 API that provides access to the popular Czech school management system. It enables users to retrieve schedules, permanent timetables, absence records, and grades through a standardized interface.3MIT
- Flicense-qualityCmaintenanceAn MCP server for interacting with the MyDy (Moodle-based) LMS, enabling attendance viewing, course browsing, assignment and grade checking, announcement reading, and material downloading.7
- Flicense-qualityBmaintenanceMCP server for NTUT iSchool+ that enables AI to query course schedules, syllabi, files, bulletins, and more through natural language.
- Flicense-qualityBmaintenanceMCP server that aggregates department notices and provides structured answers to queries about courses, schedules, and academic dates via tool calling.
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
An MCP server for deep research or task groups
MCP server for Zooza — class scheduling, attendance, and booking for activity businesses.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Nemoyuzx/WTS-bupt-unOfficial-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server