librus-mcp

Librus Portal 계정을 위한 로컬, 읽기 전용 MCP 서버입니다. Portal 로그인 흐름을 사용하여 선택한 Synergia 계정에 대한 유효 기간이 짧은 Librus API 토큰을 획득합니다.

보안 모델

• 자격 증명은 LIBRUS_EMAIL 및 LIBRUS_PASSWORD에서만 읽습니다.

• 쿠키와 토큰은 메모리에만 보관되며, 프로세스가 종료되거나 librus_logout이 호출되면 폐기됩니다.

• 서버는 portal.librus.pl 및 api.librus.pl에 대한 HTTPS 요청만 허용합니다.

• 읽기 전용 API 리소스의 허용 목록(allowlist)을 노출하며, 메시지를 보내거나, 공지사항을 읽음으로 표시하거나, 임의의 요청을 제출할 수 없습니다.

• 요청, 응답, 자격 증명, 토큰 또는 API 페이로드를 의도적으로 stdout/stderr에 기록하지 않습니다. stdout은 MCP 프로토콜 트래픽 전용입니다.

자격 증명을 package.json, git에 커밋된 MCP 구성, 또는 추적되는 .env 파일에 넣지 마세요.

Related MCP server: moodle-utn-mcp

설치 및 빌드

cd /home/xadix0wy/librus-mcp
npm install
npm run build

MCP 호스트 구성

호스트의 비공개 구성 또는 비밀 저장소에 환경 변수를 사용하세요:

{
  "mcpServers": {
    "librus": {
      "command": "node",
      "args": ["/home/xadix0wy/librus-mcp/dist/index.js"],
      "env": {
        "LIBRUS_EMAIL": "your-email@example.com",
        "LIBRUS_PASSWORD": "your-password"
      }
    }
  }
}

LIBRUS_CLIENT_ID는 선택 사항입니다. 기본값은 레거시 Librus 모바일 흐름의 공개 클라이언트 ID입니다. 이 값은 비밀로 취급되지 않습니다.

도구

• librus_profiles: Portal 계정에 연결된 Synergia 계정을 나열합니다.

• librus_get: 성적, 출석, 시간표, 숙제, 공지사항, 학교 정보 및 기타 지원되는 API 리소스를 읽습니다. librus_profiles의 account_login을 전달하세요.

• librus_logout: 메모리에 있는 모든 인증 자료를 삭제합니다.

Portal은 reCAPTCHA 또는 계정 조치를 요구할 수 있습니다. 이 경우 서버는 명확한 오류와 함께 중지됩니다. https://portal.librus.pl 또는 공식 앱에서 필요한 조치를 완료한 후 다시 시도하세요.

호환성

이 도구는 레거시 Szkolny Android 소스에서 발견된 문서화되지 않은 Portal/API 흐름에 의존합니다. Librus는 사전 통지 없이 이를 변경하거나 제한할 수 있습니다. 이 도구는 오직 계정 소유자만을 위한 것이며, Librus 이용약관 및 학교 정책에 따라 사용해야 합니다.