Skip to main content
Glama
deenesjakoruzh
chrischall

schoolpass-mcp

by chrischall
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

schoolpass-mcp

用于 SchoolPass 的 MCP 服务器 —— 从家长账户读取并修改孩子的上学到达与放学离校信息。它对接 SchoolPass 网页端和移动端所使用的 SchoolPass REST API，在服务端使用你自己的家长邮箱和密码进行认证（无需浏览器，无需扩展）。

由 AI（Claude Code）开发和维护。请自行斟酌使用。

家长权限范围：包含读取工具，以及一个需确认门控的离校修改写入/取消工具。

工具

工具

功能说明

schoolpass_healthcheck

可达性 + 认证状态，分别报告。

schoolpass_whoami

服务器登录所用的家长身份。

schoolpass_list_students

你关联的学生 —— 姓名、年级、家庭离校地点、课后托管。

schoolpass_get_profile

家长账户资料。

schoolpass_list_drivers

已授权的接人司机及其拼车信息。

schoolpass_get_calendar

某学生在指定日期范围内的到达/离校日历。

schoolpass_list_pickup_changes

某学生在某日期的接人/离校变更。

schoolpass_list_dismissal_locations

学校的离校地点及其 id。

schoolpass_get_school_info

学校基本信息及各校配置。

schoolpass_submit_dismissal_change

提交离校/到达变更（需确认门控，支持 dry-run 预览）。

schoolpass_cancel_dismissal_change

取消变更，恢复默认（需确认门控）。

配置

环境变量

是否必需

说明

SCHOOLPASS_EMAIL

是

你的 SchoolPass 家长账户邮箱。

SCHOOLPASS_PASSWORD

是

你的 SchoolPass 密码。

SCHOOLPASS_SCHOOL_CODE

是

学校数字 id（即 AppCode / appCode 值；例如 1183）。

SCHOOLPASS_API_HOST

否

区域 API 主机覆盖（默认 busapi-east16-ss.school-pass.net）。

如何找到学校 id 和区域主机： 登录你学校的 <school>.school-pass.net 门户，打开新版 SchoolPass 应用，然后从浏览器的 localStorage 中读取 appCode（即 id）和 apiUrl（即主机）。

安装

{
  "mcpServers": {
    "schoolpass": {
      "command": "npx",
      "args": ["-y", "schoolpass-mcp"],
      "env": {
        "SCHOOLPASS_EMAIL": "you@example.com",
        "SCHOOLPASS_PASSWORD": "your-password",
        "SCHOOLPASS_SCHOOL_CODE": "1183"
      }
    }
  }
}

备注

  • 仅限家长权限。 家长令牌无法访问管理路由（访客管理、车队运营、报表、校车路线）；这些路由会返回 403。

  • 绝不重试被拒绝的登录。 SchoolPass 在登录前设有 reCAPTCHA；反复失败可能导致账户被质询。

  • 无凭据也能启动。 服务器在无配置的情况下也能启动并响应 tools/list；配置错误会在首次工具调用时暴露。

不使用服务器：curl

SchoolPass API 可在服务端访问，因此一次性的 shell 读取无需 MCP 进程 —— 参见随附的 schoolpass-curl 技能（skills/schoolpass-curl/），其中包含一套 curl + jq 的配方。

开发

npm install
npm test            # unit + boot tests
npm run build       # tsc + esbuild bundle
node --env-file=.env scripts/live-check.mjs   # live read-only check (needs .env)

许可证

MIT

This server cannot be installed

-
license - not tested
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (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 Connectors

  • mjucius-cozi_mcp

    Manage your family's calendars and lists in Cozi. View, create, and update appointments; organize…

  • Calendly

    Calendly MCP Pack — wraps the Calendly API v2 for scheduling data.

  • paxaver-mcp

    MCP adapter for the Paxaver school community platform. Streamable HTTP, OAuth 2.1, capability auth.

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/chrischall/schoolpass-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server