kad-xyz / spbstu-mcp

# spbstu-mcp
**Your Peter the Great St. Petersburg Polytechnic University (SPbPU) studies, available to Claude.**
An MCP server for SPbPU student services: the dl.spbstu.ru Moodle,
the university mailbox, openedu.ru and the timetable. You sign in with your university account; your password stays in your
operating system's credential store.
**English** · Русский
https://github.com/user-attachments/assets/79137c69-5d3f-4270-9164-e509f88c3535
---
> *"What's due this week?"* · *"Summarise the database course assignment and download its files."* ·
> *"Did the teacher grade my coursework?"* · *"Draft a reply to the curator's email."*
## Contents
- What it does
- Quick start
- Tools
- How it works
- Security and privacy
- Configuration
- Troubleshooting
- Development
- Contributing
## What it does
| | Service | Read | Write |
|---|---|---|---|
| 🎓 | **dl.spbstu.ru**, the Moodle LMS | courses, course contents, assignments with full task text, deadlines, submission status and feedback, grades, forums, pages, files | submit work to an assignment, post to forums with attachments |
| ✉️ | **mail.spbstu.ru**, Exchange | list and search mail, read messages, save attachments | write new messages and replies (saved as drafts by default), delete |
| 📚 | **openedu.ru**, Open edX | enrolled courses, progress and grades, due dates, course outline, page text and attached files | |
| 🗓 | **ruz.spbstu.ru**, the public timetable | weekly timetable of any group or teacher | |
| 🧭 | **Everything at once** | `study_overview`: dl deadlines, openedu.ru progress and unread mail in one call | |
| 🏛 | **my.spbstu.ru**, «Мой Политех» | record book grades with semester averages, study plan, this year's work plan | |
| 🔎 | **polyvsp.ru, polyphis.ru**, student answer bases | answers to test questions, with the source page | |
## Quick start
**1. Store your university login** in the operating system's credential store. `LOGIN` is your single university
account, the one in `LOGIN@edu.spbstu.ru`.
 macOS : keychain 
 [code] 
> [!IMPORTANT]
> Keep `-w` **last**, so that `security` prompts for the password with hidden input; anything after `-w` would be
> stored as the password itself. To check (prints only the length): `security find-generic-password -s spbstu -w | wc -c`
 Linux : Secret Service (GNOME Keyring, KWallet) 
Needs `secret-tool` (`apt install libsecret-tools`, `dnf install libsecret`, `pacman -S libsecret`):
 [code] 
 Windows : Credential Manager 
 [code] 
The password is asked with hidden input in every case.
**2. Install the server.** With Homebrew (macOS, Linux):
 [code] 
Or download the archive for your system from Releases
and put `spbstu-mcp` somewhere on disk, e.g. `~/.local/bin`. On macOS, clear the download quarantine (the binary is not
notarized):
 [code] 
 Or build from source (Go 1.26+) 
 [code] 
**3. Connect it to Claude.**
 Claude Code Claude Desktop 
 [code] 
`claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\Clau