我的商大 MCP

把分散的校园入口，变成可以直接提问的只读工具。

面向浙江工商大学「我的商大」及相关校园系统的个人 MCP 服务。 你在支持 MCP 的 AI 客户端里提问，由客户端选择工具，读取本人有权访问的数据并整理回答。

Python 3.12+ · MCP / stdio · SQLite 本地缓存 · 47 个注册工具 · 338 项合成测试 · MIT License

公开版本：main，47 个注册工具（2026-10-19）。 提供培养方案附件正文、寝室电表及图书馆余座入口，以及教务激活、考试缓存和存储维护实现。供个人账号按需只读使用；本仓库从脱敏当前文件独立建立，不包含旧开发仓库的提交历史。 47 是注册数；不等于全部业务验收通过，各工具的口径与边界以说明为准。 本项目为个人开发实践，不代表学校官方产品或官方开放 API。

验证与限制： 当前公开副本通过 338 项合成回归和本地 stdio 检查；相关实现此前另有激活门禁 37 项、电表迁移 13 项独立检查通过。电表旧配置中的既有非空定位冲突已拒绝。图书馆余座默认不发送明文身份 Cookie，提供官方人工入口。47 是注册数，不代表全部学校业务真人验收；WorkBuddy 全程耗时未复验。详见当前成果与使用边界。

快速开始 · 工具索引 · 实现原理 · 已知限制 · 验证记录

成绩总表、成绩明细、两种课表及考试已加入60秒短时复用；要最新可要求强制刷新。重载MCP后生效，行为与实测边界见查询提速。

查询本学期修读课程学分时，网页课表会同时返回同一完整本地快照的已知学分小计、缺口及分段耗时，减少额外探查课程库和培养方案。小计仍以课表可见范围为限。

为什么做这个

查课表、成绩、考试、通知和学校规定，往往需要切换 App、网页和多个子系统。 这个项目希望减少找入口、重复跳转和手工整理：保留学校原有权限，在个人电脑上把可读信息接成统一工具。

MCP 可以理解为 AI 客户端与校园查询程序之间的标准连接方式。 本仓库提供查询程序，AI 客户端负责理解自然语言、选择参数和组织回答；程序本身不内置大模型。

Related MCP server: studylife-mcp

可以怎样问

今天有没有宣讲会？列出时间、地点和来源。
查我指定学期的考试安排。
查本学期成绩，并说明是否已经读完所有页面。
最近有哪些奖学金公示？打开其中一条正文。
劳动教育现在有哪些课程？查看其中一门的详情。
学生手册对我关心的事项怎么规定？给出出处和版本。
图书馆有哪些中文期刊资源？
我提交的流程目前是什么状态？只查询，不处理。

部分问题需要本人有效会话；未接通、权限拒绝和读取失败应如实说明。 来源失败不能回答成「没有记录」，只读列表也不能当作完整历史。

功能概览

完整名称和参数见工具索引。同一组中的不同来源有独立的认证和覆盖范围。

上表合计 47 个注册工具。培养方案正文需有效教务会话并精确匹配方案和年级；电表需本人核实的定位配置；余座默认提供官方人工入口。来源的实际可用性与验证范围见当前成果。

**仍有缺口：**综测业务结果映射、部分附件格式和文本完整性，以及本人劳动非空时数/完成记录的真实对照等。 部分历史正文、详情和分页分支仍有限定使用说明，见限制清单。

快速开始

推荐先连接公开查询，确认客户端能发现工具，再按需要配置本人认证。

1. 准备本地环境

需要 Python 3.12 或更新版本，以及支持本地 stdio MCP 的客户端。 App 登录中的 Java 加密桥还需要完整 JDK；本次本地测试使用 JDK 21。

git clone https://github.com/Yingye66/zjgsu-campus-mcp-open-source.git
cd zjgsu-campus-mcp-open-source
python -m venv .venv
& .\.venv\Scripts\python.exe -m pip install -r requirements.txt

本仓库公开可克隆；个人查询仍需要使用者自己的合法账号和本机配置。 依赖版本来自本次验证环境；尚未声称所有系统和全新网络环境都已安装验证。

2. 配置 MCP 客户端

将 examples/mcp-config.example.json 中的路径替换为你本机的绝对路径，合并到客户端已有配置：

{
  "mcpServers": {
    "zjgsu-campus": {
      "command": "C:/path/zjgsu-campus-mcp-open-source/.venv/Scripts/python.exe",
      "args": ["-m", "src.mcp_server.server"],
      "env": {
        "PYTHONPATH": "C:/path/zjgsu-campus-mcp-open-source",
        "ZJGSU_CAMPUS_DATA_DIR": "C:/path/private-campus-data"
      }
    }
  }
}

保存后重载该 MCP，先问一条公开问题，例如「查最近的奖学金公示并给出处」。 MCP 客户端会启动服务进程，不需要额外启动一个后台 Web 服务。

3. 按需建立本人会话

**公开查询不要求先登录学校。**个人课表、成绩等需要对应学校会话。 私有认证还需要本机合法取得的客户端配置，仓库不提供实际常量、Cookie、token 或反编译产物。 具体前提和步骤见认证配置。

$env:ZJGSU_CAMPUS_DATA_DIR = "C:/path/private-campus-data"
& .\.venv\Scripts\python.exe -m src.auth.login_cli init

只在本人交互式终端输入凭据。App 登录成功不等于教务 CAS 已成功；体测专用令牌也是独立流程。 没有对应私有配置时，先使用公开能力，不要反复登录或把凭据交给 AI。

怎么判断回答是否可信

工具除了数据，还返回来源、查询范围、取得时间和缺口：

只有来源成功、范围一致且有足够完整性证据，才能把空结果解释为「该来源中没有找到」。

实现结构

flowchart LR
    A[支持 MCP 的 AI 客户端] --> B[stdio MCP 工具]
    B --> C[服务层：参数与范围校验]
    C --> D[来源适配器：公开页与本人会话]
    D --> E[学校原有系统]
    C <--> F[本机 SQLite 快照]
    C --> G[数据 / 出处 / 时间 / 缺口]

认证 CLI 与 MCP 查询协议分离；账号和查询范围用于隔离本地快照。 学校系统的权限、开放周期和网络条件仍然有效。详见架构说明。

开发与测试

& .\.venv\Scripts\python.exe -m pip install -r requirements-dev.txt
& .\.venv\Scripts\python.exe -m unittest discover -s test -t . -v

当前 main 累计 338 项合成回归；本地 stdio 可发现 47 个工具。测试使用合成来源和临时数据库，发布验证期间禁用学校 HTTP。工具注册、契约测试与真实业务可用性分别记录。 脱敏发布副本的最终结果见验证记录，不以本地测试代替真实学校账号或客户端界面验收。

范围与隐私

• 只查询，不代报名、签到、预约、支付、续借、提交或审批。

• 本人借阅已经取消；公开书目检索和图书馆公开信息保留。

• 校园卡与畅约及跳转畅约的入口只作人工导航，不采集相关数据。

• 私人会话与缓存仅保留本机；会话文件目前为明文 JSON，需妥善保护。

• 本仓库不包含原始私人记录、账号配置、学校 APK、反编译产物或历史私人交接。

• 不部署公共代查服务，不共享账号，不绕过权限或平台限制。

参与和维护

遇到问题，提供去身份的提问、工具名、日期/学期范围、错误类别和发生时间即可。 不要提交密码、Cookie、token、学号或完整私人回包。参见贡献说明与安全说明。

本项目按实际故障、学校来源变化或明确新需求维护；不自动启动监控或持续后台采集。 本项目源码与随附文档采用 MIT License，允许使用、修改和分发，须保留版权与许可声明。依赖及第三方系统资料分别遵循其自身条款；本许可不授予学校数据、账号或受限服务的访问权限。

联系作者