Skip to main content
Glama
Nemoyuzx
by Nemoyuzx

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

联合查询:今日课程 + 每节次空闲教室数 + 当前节次空闲教室 + 全天空闲教室

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

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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