librus-mcp

面向 Librus Portal 账户的本地、只读 MCP 服务器。它使用 Portal 登录流程，为所选 Synergia 账户获取一个短期的 Librus API 令牌。

安全模型

• 凭据仅从 LIBRUS_EMAIL 和 LIBRUS_PASSWORD 读取。

• Cookie 和令牌仅保存在内存中，进程退出或调用 librus_logout 时即被丢弃。

• 服务器仅允许 HTTPS 请求访问 portal.librus.pl 和 api.librus.pl。

• 它仅暴露一个只读 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 条款和学校政策使用。