WTS-bupt-unOfficial-mcp

非官方北邮（BUPT）移动教务 MCP（Model Context Protocol）服务：查询今日空教室、课程表，以及两者的联合查询。

服务请求参考并移植自开源项目 where_to_study。

⚠️ 本项目为非官方服务，仅供学习交流，请勿滥用。使用即表示你同意自行承担账号风险。

功能（MCP Tools）

Tool	说明
get_campuses	校区信息（西土城 01 / 沙河 04）及主要教学楼
get_classrooms	查询今日空教室，支持按 campus_id / slot（1-14 节）/ building 过滤
get_schedule	查询课程表，默认当前周，支持 week（周次）或 date（日期所在周）
get_today_overview	联合查询：今日课程 + 每节次空闲教室数 + 当前节次空闲教室 + 全天空闲教室

快速开始

1. 克隆与安装

git clone https://github.com/Nemoyuzx/WTS-bupt-unOfficial-mcp.git
cd WTS-bupt-unOfficial-mcp
npm install
npm run build

2. 配置环境变量

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

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

MIT