EjAj w Eduwulkanie

Lokalny serwer MCP (stdio) łączący się z EduVulkan. Wspiera multitenancy, cache sesji, pobieranie wiadomości, ocen, zadań.

Przykładowe zapytania i zwroty z serwera MCP:

• Node.js v18+
• Działające konto rodzica/opiekuna na eduvulcan.pl
• Claude Code lub Gemini CLI

claude mcp add edu-vulcan-mcp \
  --env VULCAN_ALIAS=Twój_Alias \
  --env VULCAN_PASSWORD=Twoje_Hasło \
  -- npx -y github:budzikt/edu-vulcan-mcp

1. Dodaj marketplace (tylko raz):

   claude plugin marketplace add budzikt/edu-vulcan-mcp

2. Zainstaluj wtyczkę:

   claude plugin install edu-vulcan-mcp@edu-vulcan-marketplace --scope local

3. Podaj dane logowania – Claude zapyta Cię o alias i hasło podczas włączania wtyczki. Hasło jest przechowywane bezpiecznie w systemowym pęku kluczy (Keychain / Credentials).

Na koniec zrestartuj Claude'a – edu-vulcan-mcp powinien być podpięty: sprawdź komendą /mcp

gemini extensions install https://github.com/budzikt/edu-vulcan-mcp

Gemini CLI automatycznie zapyta Cię o VULCAN_ALIAS oraz VULCAN_PASSWORD, bezpiecznie je zapisze i skonfiguruje serwer MCP bez konieczności ręcznej edycji plików.

git clone https://github.com/budzikt/edu-vulcan-mcp.git
cd edu-vulcan-mcp
npm install
cp .env.example .env
# Wpisz swoje dane do .env
npm run mcp

Ważne: Twoje dane logowania nie trafiają do agenta — są używane wyłącznie w automatycznym procesie pozyskiwania sesji. To serwer MCP STDIO, więc nie jest dostępny przez sieć.

Narzędzia, o użycie których możesz poprosić asystenta kod:

• list_journal_accounts – Sprawdź, jakie konta uczniów (dzieci) widzę pod Twoim loginem.
• list_grades – "Claude, jakie są oceny?" i już wszystko wiesz.
• list_assignments – Zobacz, co tam wpadło do kalendarza (sprawdziany, zadania).
• get_assignment_details – Jak chcesz wiedzieć dokładnie, co trzeba zrobić w tym zadaniu z plastyki.
• list_mailboxes – Zobacz, jakie masz skrzynki pocztowe.
• list_messages – Szybki podgląd ostatnich wiadomości od wychowawcy.
• get_message_details – Przeczytaj całą wiadomość bez wchodzenia na stronę.
• get_messages_details_bulk – Pobierz kilka wiadomości naraz, żeby nie marnować czasu.

Serwer wymaga dwóch zmiennych środowiskowych, które podajesz podczas instalacji:

• VULCAN_ALIAS – To ten krótki identyfikator, którego używasz do logowania na stronie.
• VULCAN_PASSWORD – Twoje hasło. Przechowywane w systemowym pęku kluczy.

Dane te nie są udostępniane do LLM — używane wyłącznie do uwierzytelniania przez tool call.

• cała masa xD
• eduVulkan od czasu do czasu wymaga captcha - to prosta captcha "na czekania". Obecnie MCP nie wspiera zarządzania tym przypadkiem. Jeśli MCP nie będzie umiał się zalogować, wykonaj jakąś "ludzką" akcję na swoim koncie EduVulkan a captchaaut zniknie
• czytanie wiadomości w trybie bulk niepotrzebnie eksponuje id wiadomości i zmusza LLM do zarządzania nimi

• cache sesji per dziecko
• dzielony obiekt cookie-jar pomiedzy wywołaniami per to samo dziecko
• wydzielony flow autoryzacyjny dla tooli

ISC – bierz i korzystaj!