schoolpass-mcp

SchoolPass용 MCP 서버 — 학부모 계정에서 자녀의 학교 등교 및 하교를 조회하고 변경할 수 있습니다. SchoolPass 웹 및 모바일 앱에서 사용하는 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 프로세스가 필요 없습니다. curl + jq 레시피 모음은 번들된 schoolpass-curl 스킬(skills/schoolpass-curl/)을 참조하세요.

개발

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