librus-mcp

Librus Portal アカウント向けの、ローカルで読み取り専用の MCP サーバーです。選択した Synergia アカウント用の短時間有効な Librus API トークンを取得するために、Portal のログインフローを使用します。

セキュリティモデル

• 認証情報は LIBRUS_EMAIL と LIBRUS_PASSWORD からのみ読み取ります。

• Cookie とトークンはメモリ上に保持され、プロセスが終了するか librus_logout が呼び出されると破棄されます。

• サーバーは portal.librus.pl と api.librus.pl への HTTPS リクエストのみを許可します。

• 読み取り専用の API リソースの許可リストのみを公開します。メッセージを送信したり、お知らせを既読にしたり、任意のリクエストを送信したりすることはできません。

• リクエスト、レスポンス、認証情報、トークン、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 の利用規約と学校の方針に従って使用されるべきものです。