schoolpass-mcp

MCP-сервер для SchoolPass — чтение И изменение прибытия и убытия вашего ребёнка в школу из родительского аккаунта. Общается с REST API SchoolPass, используемым веб-приложением и мобильными приложениями SchoolPass, выполняя аутентификацию на стороне сервера с вашим родительским email и паролем (без браузера, без расширений).

Разработано и поддерживается ИИ (Claude Code). Используйте на свой страх и риск.

Ограничено родительским доступом: инструменты чтения плюс запись/отмена изменения убытия с подтверждением.

Tools

Configuration

Поиск идентификатора школы и регионального хоста: войдите на портал вашей школы <school>.school-pass.net, откройте новое приложение SchoolPass и прочитайте appCode (идентификатор) и apiUrl (хост) из его localStorage в браузере.

Install

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

Notes

• Только родительский доступ. Родительский токен не может получить доступ к административным маршрутам (управление посетителями, операции carline, отчёты, маршрутизация автобусов); они возвращают 403.

• Никогда не повторяйте отклонённый вход. SchoolPass защищает вход с помощью reCAPTCHA; повторные неудачи могут привести к блокировке аккаунта.

• Без учётных данных всё равно запускается. Сервер запускается без конфигурации и отвечает на tools/list; ошибка конфигурации появляется при первом вызове инструмента.

Without the server: curl

API SchoolPass доступен на стороне сервера, поэтому разовое чтение из оболочки не требует процесса MCP — см. встроенный навык schoolpass-curl (skills/schoolpass-curl/) для набора рецептов curl + jq.

Development

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)

License

MIT