WTS-bupt-unOfficial-mcp
WTS-bupt-unOfficial-mcp
Servicio MCP (Model Context Protocol) no oficial para la gestión académica móvil de la Universidad de Correos y Telecomunicaciones de Beijing (BUPT): consulta de aulas vacías de hoy, horario de clases y consulta combinada de ambos.
La solicitud del servicio se basa en el proyecto de código abierto where_to_study, adaptado del mismo.
⚠️ Este proyecto es un servicio no oficial, destinado únicamente al aprendizaje y la comunicación. No lo utilices de forma abusiva. Al usarlo, aceptas asumir el riesgo sobre tu cuenta.
Funcionalidades (Herramientas MCP)
Herramienta | Descripción |
| Información de los campus (Xitucheng 01 / Shahe 04) y los principales edificios docentes |
| Consulta de aulas vacías hoy, con filtros por |
| Consulta del horario de clases, por defecto la semana actual; admite |
| Consulta combinada: clases de hoy + número de aulas libres por sesión + aulas libres en la sesión actual + todas las aulas libres del día |
Related MCP server: mydy-lms
Inicio rápido
1. Clonar e instalar
git clone https://github.com/Nemoyuzx/WTS-bupt-unOfficial-mcp.git
cd WTS-bupt-unOfficial-mcp
npm install
npm run build2. Configurar las variables de entorno
export BUPT_USER_NO=你的学号
export BUPT_PWD=你的移动教务密码
export BUPT_CAMPUS_ID=01 # 可选,默认 01=西土城;04=沙河
export BUPT_TERM_START_DATE= # 可选,学期开学日 YYYY-MM-DD(无法从接口推断时兜底)3. Ejecutar directamente
node dist/index.js4. Conectar a clientes MCP como Claude Desktop / Cursor
En la configuración del cliente MCP, añadir (modo stdio):
{
"mcpServers": {
"wts-bupt": {
"command": "node",
"args": ["/绝对路径/WTS-bupt-unOfficial-mcp/dist/index.js"],
"env": {
"BUPT_USER_NO": "你的学号",
"BUPT_PWD": "你的密码",
"BUPT_CAMPUS_ID": "01"
}
}
}
}Ejemplos de uso
Pregunta al cliente MCP:
«Consulta qué aulas vacías hay hoy en el campus de Shahe en la sesión 3»
«¿Qué clases tengo esta semana?»
«¿Qué aulas están libres ahora?» (consulta combinada:
get_today_overview)
Desarrollo y pruebas
npm test # 使用 where_to_study 的原始响应样例做解析器单测
npm run build # 编译到 dist/Estructura de directorios
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 # 单元测试(含参考项目原始响应样例)Licencia
Available Tools
4 toolsget_campuses获取北邮校区信息A
返回北邮移动教务支持的两个校区(西土城 01 / 沙河 04)及其主要教学楼,用于空教室查询时选择 campus_id。
Inputs: no named parameters.
get_classrooms获取今日空教室A
查询北邮移动教务的今日空教室。返回每个教室今日空闲的节次(1-14节)与时间。可选参数:campus_id(默认取环境变量 BUPT_CAMPUS_ID,01=西土城,04=沙河)、slot(1-14,只看该节次空闲的教室)、building(按教学楼名过滤,如"教1"、"主楼"、"综合教学楼N")。
Inputs: slot, building, campus_id.
get_schedule获取课程表A
查询北邮移动教务的课程表。默认返回当前周的课程;可通过 week 指定周次,或通过 date(YYYY-MM-DD)指定日期所在的周。返回课程名称、教师、教室、节次与时间。
Inputs: date, week.
get_today_overview今日空教室与课表联合查询A
一次查询返回:今日日期/星期/当前周次、今日课程列表、课程占用节次、每个节次的空闲教室数量、当前节次空闲教室、全天空闲教室。用于回答"今天有哪些课""现在哪些教室空着""第 X 节有哪些空教室"等问题。
Inputs: campus_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clear, distinct purpose: campuses list, classroom availability, schedule, and a combined daily overview. There is no overlap; get_classrooms and get_today_overview serve different query granularities.
All tools follow a consistent 'get_' prefix with lowercase underscore-separated names. The verb_noun pattern is uniform, even the compound name 'get_today_overview' fits the pattern without mixing conventions.
With 4 tools, the server is tightly scoped to the domain of querying campus, classroom, and schedule information. Each tool earns its place, and the count is neither too few nor excessive for a focused utility.
The tool set covers the core queries for a university timetable system: campuses, empty classrooms (with filters), schedule, and a combined overview. Minor gaps like querying classroom details or multi-day views exist, but the surface is practical and unlikely to cause agent failures.
Maintenance
Related MCP Connectors
MCP server providing attendance data queries via the CloudTime API.
MCP server for China Railway 12306 ticket availability: schedules and seats by Chinese station name.
MCP server for China Railway 12306 ticket availability: schedules and seats by Chinese station name.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn 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
- AlicenseNot gradedqualityBmaintenanceAn MCP server for interacting with the MyDy (Moodle-based) LMS, enabling attendance viewing, course browsing, assignment and grade checking, announcement reading, and material downloading.7MIT
- FlicenseNot gradedqualityDmaintenance武汉大学校园服务 MCP 服务器,提供图书馆座位、课表、成绩、考试、天气等工具,通过 SSE 协议供 Claude Code 远程调用。-
- FlicenseCqualityDmaintenanceMCP server that reads Korean school class and teacher timetables from Comci's public schedules, detects schedule changes, and exposes structured data via CLI, local REST, and MCP stdio.81-