Librus Synergia MCP
An open-source MCP server that allows AI assistants to interact with the Librus Synergia school platform. It enables agents to retrieve student grades, check attendance records, view timetables, access homework assignments, read messages, and view announcements. It supports local execution via uvx, desktop bundles for Claude Desktop, and self-hosted Docker deployments with HTTP transport and bearer token authentication.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 14 GitHub stars
What you can do with it
- Retrieve student grades and academic performance data
- Check daily attendance records
- View class timetables and schedules
- Access homework assignments and school messages
Source and maintenance
- Last repository push
- Latest release
- v2.5.2
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
ghcr.io/krzysztofbury/librus-mcp:2.5.1
{
"transport": "stdio",
"identifier": "ghcr.io/krzysztofbury/librus-mcp:2.5.1",
"runtimeHint": "docker",
"registryType": "oci",
"runtimeArguments": [
{
"name": "--mount",
"type": "named",
"value": "type=volume,src=librus-mcp-data,dst=/data",
"description": "Keeps the server's private state, such as notification history, between runs."
}
],
"environmentVariables": [
{
"name": "LIBRUS_USERNAME",
"isRequired": true,
"description": "Librus Synergia login."
},
{
"name": "LIBRUS_PASSWORD",
"isRequired": true,
"description": "Librus Synergia password."
},
{
"name": "LIBRUS_ALIAS",
"default": "librus",
"description": "Short name for this login in tool calls."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"librus-synergia-mcp-2-5-1": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"LIBRUS_USERNAME=<YOUR_LIBRUS_USERNAME>",
"-e",
"LIBRUS_PASSWORD=<YOUR_LIBRUS_PASSWORD>",
"-e",
"LIBRUS_ALIAS=<YOUR_LIBRUS_ALIAS>",
"ghcr.io/krzysztofbury/librus-mcp:2.5.1"
],
"env": {
"LIBRUS_USERNAME": "<YOUR_LIBRUS_USERNAME>",
"LIBRUS_PASSWORD": "<YOUR_LIBRUS_PASSWORD>",
"LIBRUS_ALIAS": "<YOUR_LIBRUS_ALIAS>"
}
}
}
}Cline
{
"mcpServers": {
"librus-synergia-mcp-2-5-1": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"LIBRUS_USERNAME=<YOUR_LIBRUS_USERNAME>",
"-e",
"LIBRUS_PASSWORD=<YOUR_LIBRUS_PASSWORD>",
"-e",
"LIBRUS_ALIAS=<YOUR_LIBRUS_ALIAS>",
"ghcr.io/krzysztofbury/librus-mcp:2.5.1"
],
"env": {
"LIBRUS_USERNAME": "<YOUR_LIBRUS_USERNAME>",
"LIBRUS_PASSWORD": "<YOUR_LIBRUS_PASSWORD>",
"LIBRUS_ALIAS": "<YOUR_LIBRUS_ALIAS>"
}
}
}
}VS Code
{
"servers": {
"librus-synergia-mcp-2-5-1": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"LIBRUS_USERNAME=<YOUR_LIBRUS_USERNAME>",
"-e",
"LIBRUS_PASSWORD=<YOUR_LIBRUS_PASSWORD>",
"-e",
"LIBRUS_ALIAS=<YOUR_LIBRUS_ALIAS>",
"ghcr.io/krzysztofbury/librus-mcp:2.5.1"
],
"env": {
"LIBRUS_USERNAME": "<YOUR_LIBRUS_USERNAME>",
"LIBRUS_PASSWORD": "<YOUR_LIBRUS_PASSWORD>",
"LIBRUS_ALIAS": "<YOUR_LIBRUS_ALIAS>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"librus-synergia-mcp-2-5-1": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"LIBRUS_USERNAME=<YOUR_LIBRUS_USERNAME>",
"-e",
"LIBRUS_PASSWORD=<YOUR_LIBRUS_PASSWORD>",
"-e",
"LIBRUS_ALIAS=<YOUR_LIBRUS_ALIAS>",
"ghcr.io/krzysztofbury/librus-mcp:2.5.1"
],
"env": {
"LIBRUS_USERNAME": "<YOUR_LIBRUS_USERNAME>",
"LIBRUS_PASSWORD": "<YOUR_LIBRUS_PASSWORD>",
"LIBRUS_ALIAS": "<YOUR_LIBRUS_ALIAS>"
}
}
}
}Let your agent find its tools
Find servers like Librus Synergia MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.