schoolpass-mcp

SchoolPass 用の MCP サーバー — 保護者アカウントからお子様の学校への到着・下校を読み取り、変更します。SchoolPass の Web アプリとモバイルアプリが使用する SchoolPass REST API と通信し、ご自身の保護者メールアドレスとパスワードでサーバー側で認証します（ブラウザも拡張機能も不要）。

AI（Claude Code）によって開発・保守されています。ご自身の判断でご使用ください。

保護者スコープ: 読み取りツールに加え、確認ゲート付きの下校変更の書き込み/キャンセル。

ツール

設定

学校 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 はサーバー側からアクセスできるため、一度きりのシェル読み取りには 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