Skip to main content
Glama
WTS-bupt-unOfficial-mcp
by Nemoyuzx

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

get_campuses

Información de los campus (Xitucheng 01 / Shahe 04) y los principales edificios docentes

get_classrooms

Consulta de aulas vacías hoy, con filtros por campus_id / slot (sesiones 1-14) / building

get_schedule

Consulta del horario de clases, por defecto la semana actual; admite week (número de semana) o date (semana que contiene la fecha)

get_today_overview

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 build

2. 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.js

4. 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

MIT

Available Tools

4 tools
get_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

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers