claudeers.
// MCP Servers

spbstu-mcp

MCP server for SPbPU (Polytech) students: dl.spbstu.ru Moodle, university mail and openedu.ru for Claude

// MCP Servers[ api ][ desktop ][ web ][ mobile ][ claude ]#claude#golang#mcp#mcp-server#moodle#openedx#polytech#spbstu#mcp-servers◷ MIT$open-sourceupdated 30 days ago
Actively maintained
100/100
last commit 23 days ago
last release 23 days ago
releases 16
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up spbstu-mcp (release-binary project) into my current project.
Found on https://claudeers.com/spbstu-mcp
Repo: https://github.com/kad-xyz/spbstu-mcp
Homepage/docs: —
Detected install method: release-binary → inspect the README
Category: mcp-servers. Platforms: api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/kad-xyz/spbstu-mcp/releases
// or clone
git clone https://github.com/kad-xyz/spbstu-mcp

// compatibility

Platformsapi, desktop, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageGo

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

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

ServiceReadWrite
🎓dl.spbstu.ru, the Moodle LMScourses, course contents, assignments with full task text, deadlines, submission status and feedback, grades, forums, pages, filessubmit work to an assignment, post to forums with attachments
✉️mail.spbstu.ru, Exchangelist and search mail, read messages, save attachmentswrite new messages and replies (saved as drafts by default), delete
📚openedu.ru, Open edXenrolled courses, progress and grades, due dates, course outline
🗓ruz.spbstu.ru, the public timetableweekly timetable of any group or teacher
🧭Everything at oncestudy_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

Quick start

1. Store your university login in the operating system's credential store. LOGIN is your single university account, the one in [email protected].

macOS: keychain
security add-generic-password -s spbstu -a [email protected] -T /usr/bin/security -w

[!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):

secret-tool store --label=spbstu service spbstu account [email protected]
Windows: Credential Manager
cmdkey /generic:spbstu /user:[email protected] /pass

The password is asked with hidden input in every case.

2. Install the server. With Homebrew (macOS, Linux):

brew install kad-xyz/tap/spbstu-mcp

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):

xattr -d com.apple.quarantine ~/.local/bin/spbstu-mcp
Or build from source (Go 1.26+)
go install github.com/kad-xyz/spbstu-mcp/cmd/spbstu-mcp@latest

3. Connect it to Claude.

Claude CodeClaude Desktop
claude mcp add spbstu -s user -- "$(command -v spbstu-mcp)"

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "spbstu": { "command": "/Users/YOU/.local/bin/spbstu-mcp" }
  }
}

Then just ask: "What's going on with my studies?"

[!TIP] No account at hand? Start the server with -demo (claude mcp add spbstu-demo -- spbstu-mcp -demo): it serves a made-up student's courses, deadlines and mail, touches no university service and needs no credentials.

Tools

Across services: 3 tools
ToolDescription
study_overviewdl.spbstu.ru deadlines (with recently overdue ones), progress in current openedu.ru courses and unread mail. A source that fails is reported, the rest still come back.
study_subjectEverything about one discipline: work-plan hours and control type, the dl course with assignments, quizzes, deadlines and teachers, grades received.
study_export_icsEvery upcoming dl and openedu due date as an .ics file with day-before reminders, for Apple, Google or Outlook Calendar.
dl.spbstu.ru: 20 tools
ToolDescription
dl_coursesCourses you are enrolled in (current ones, or all).
dl_course_contentsSections of a course with their activities, descriptions and file links.
dl_deadlinesUpcoming and recently overdue due dates across all courses.
dl_assignmentsAssignments of a course: full task text, due dates, attached files.
dl_submission_statusYour submission for an assignment: status, files, grade, teacher feedback.
dl_gradesYour grades in a course.
dl_forum_discussionsDiscussions of a forum.
dl_discussion_postsAll posts of a discussion, with attachments.
dl_pageText of a page resource (exam rules, ticket lists).
dl_downloadDownload a file to ~/Downloads/spbstu.
dl_quizzesQuizzes of a course: opening and closing time, time limit, attempts allowed and used, best grade (information only).
dl_teachersTeachers of a course and their last visit.
dl_notificationsNewest notifications: grades, feedback, forum posts, due dates.
dl_messagesPrivate conversations with their last message.
dl_conversationAll messages of a conversation.
dl_searchSearch every course for activities, resources and files.
dl_send_message ✍️Send a private message, e.g. to a teacher.
dl_submit_assignment ✍️Upload files and/or text to an assignment, optionally submit for grading.
dl_forum_new_discussion ✍️Start a discussion, e.g. post a report to an upload forum.
dl_forum_reply ✍️Reply to a post.
Mail: 9 tools
ToolDescription
mail_listNewest messages of a folder; unread only; search (from:name, subject:word, plain words).
mail_readA whole message as plain text, with recipients and attachments.
mail_download_attachmentSave an attachment to ~/Downloads/spbstu/mail.
mail_send ✍️New message or reply. Saves a draft unless send is true.
mail_delete ✍️Move a message or draft to Deleted Items (restorable).
mail_foldersMail folders with total and unread counts.
mail_moveMove messages to another folder.
mail_markMark messages read or unread.
mail_calendarEvents of the mailbox calendar: meetings, webinars, consultations.
my.spbstu.ru: 5 tools
ToolDescription
my_gradesRecord book (зачётка): every grade with control type, date and lecturer; average of each semester.
my_study_planThe programme's study plan: disciplines, semesters, hours, control type.
my_work_planThis year's work plan by semester: lecture, practice, lab and self-study hours.
my_record_booksRecord books, one per programme, with the group.
my_debtsAcademic debts: disciplines whose latest grade is failing, and past ones with no grade to check.
Timetable: 1 tool
ToolDescription
scheduleWeek of a group or a teacher: time, type, teachers, room, webinar and dl links. Ambiguous names return the candidates.
openedu.ru: 4 tools
ToolDescription
openedu_coursesYour enrolled courses.
openedu_progressCompleted units, current grade, grading policy, score of every subsection.
openedu_datesCourse start, end and due dates.
openedu_outlineChapters and subsections with completion and links.

✍️ changes something on a university service; see Security and privacy.

How it works

flowchart LR
    C[Claude] -- MCP / stdio --> S[spbstu-mcp]
    K[(OS credential store<br/>item "spbstu")] -. login + password .-> S
    S -- SSO --> CAS[cas.spbstu.ru]
    CAS --> DL[dl.spbstu.ru<br/>Moodle mobile API]
    S -- SSO --> KC[sso.openedu.ru<br/>«Политех» provider] --> CAS
    KC --> OE[courses.openedu.ru<br/>Open edX API]
    S -- EWS, Basic auth over TLS --> M[mail.spbstu.ru<br/>Exchange]
    S <-. sessions .-> ST[(~/.config/spbstu-mcp<br/>state.json, 0600)]
  • dl.spbstu.ru: signs in through the university SSO and obtains a Moodle mobile web service token, the same way the official Moodle app does.
  • openedu.ru: signs in through the «Политех» identity provider of the openedu.ru SSO, then reads the Open edX course APIs.
  • Mail: Exchange Web Services with the same account.
  • my.spbstu.ru: its own sign-in form, then the JSON endpoints its pages use.
  • Sessions (the Moodle token and cookies) are kept between runs, so the server signs in again only when a session has expired. University sites lock accounts after frequent sign-ins.

Security and privacy

  • 🔑 The password never leaves your Mac except to SPbPU and openedu.ru sign-in pages. It is read from the credential store at sign-in time and never appears in tool results.
  • 🗂 Sessions are stored in ~/.config/spbstu-mcp/state.json, readable only by you. Delete the file to sign out everywhere.
  • ✋ Writes need your confirmation. The descriptions of dl_submit_assignment, dl_forum_* and mail_send tell the model to act only after you have confirmed exactly what goes where. mail_send only saves a draft unless asked to send.
  • 🚫 No exams. The server cannot take graded tests or proctored exams, and is not meant to.

[!WARNING] This is an unofficial project, not affiliated with SPbPU or openedu.ru. Use it with your own account only.

Configuration

FlagDefaultDescription
-keychain-servicespbstuName of the credential store item with the university login.
-downloads~/Downloads/spbstuWhere downloaded files and attachments are saved.
-groupDefault group for schedule, e.g. 5130902/30201.
-demofalseServe made-up data instead of the university services; no credentials needed.

Troubleshooting

SymptomFix
keychain item "spbstu" not found (or Secret Service item, credential)Create it, see Quick start.
CAS rejected the credentialsCheck the stored password length; re-create the item with -w last.
mail.spbstu.ru rejected the credentialsThe keychain account must be the full address, [email protected].
Sign-in keeps failing after many attemptsThe site may have locked sign-ins for a while. Wait, then try once.
macOS: "cannot be opened because the developer cannot be verified"xattr -d com.apple.quarantine ~/.local/bin/spbstu-mcp

Development

go test ./...                    # offline unit tests
SPBSTU_LIVE=1 go test ./...      # plus checks against the live services (needs the credential item)
go build -o bin/spbstu-mcp ./cmd/spbstu-mcp
cmd/spbstu-mcp     MCP tools (dl, mail, openedu, overview)
internal/cas       university SSO sign-in
internal/moodle    dl.spbstu.ru client
internal/ews       Exchange Web Services client
internal/openedu   openedu.ru and Open edX client
internal/mypoly    my.spbstu.ru client
internal/ruz       public timetable client
internal/keychain  credential stores: macOS keychain, Secret Service, Windows Credential Manager
internal/state     persisted sessions and cookie jar

Releases are built by GitHub Actions on every v* tag.

Contributing

Contributions are welcome, in English or Russian: read CONTRIBUTING.md first. Security issues go through private advisories, not public issues.

License

MIT

// faq

What is spbstu-mcp?

MCP server for SPbPU (Polytech) students: dl.spbstu.ru Moodle, university mail and openedu.ru for Claude. It is open-source on GitHub.

Is spbstu-mcp free to use?

spbstu-mcp is open-source under the MIT license, so it is free to use.

What category does spbstu-mcp belong to?

spbstu-mcp is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

8 views
★ 24 stars
unclaimed
updated 30 days ago

// embed badge

spbstu-mcp on Claudeers
[![Claudeers](https://claudeers.com/api/badge/spbstu-mcp.svg)](https://claudeers.com/spbstu-mcp)

// retro hit counter

spbstu-mcp hit counter
[![Hits](https://claudeers.com/api/counter/spbstu-mcp.svg)](https://claudeers.com/spbstu-mcp)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 175,627◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 151,540◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how spbstu-mcp connects across the ecosystem