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)

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