{
  "markdown": "# edu-vulcan-mcp\n\n## tl;dr:  \nEjAj w Eduwulkanie  \n\n## dłuższe:\nLokalny serwer MCP (stdio) łączący się z EduVulkan. Wspiera multitenancy, cache sesji, pobieranie wiadomości, ocen, zadań.\n\n## Demo (Zobacz, jak to wygląda)\n\nPrzykładowe zapytania i zwroty z serwera MCP:\n### `Jakie moje dzieci chodzą tak ogólnie do szkoły, bo zapomniałem xD`  \n![img](./docs/name.png)\n### `Jakie oceny z edukacji wczesnoszkolej ma moja córka XYZ? zbierz średnie, najgorsze i najlepsze wyniki`  \n![img](./docs/grades.png)\n![img](./docs/grader-wrap.png)\n### `Podsumuj mi ostatnie 10 wiadomości z skrzynki odbiorczej mojej córki XYZ, jeśli coś wymaga akcji, dodaj to tabelki`  \n![img](./docs/mailbox-resp.png)\n![img](./docs/mailbox-wrap.png)\n\n## Jak włączyć?\n\n### Wymagania\n- Node.js v18+\n- Działające konto rodzica/opiekuna na [eduvulcan.pl](https://eduvulcan.pl)\n- Claude Code lub Gemini CLI\n\n---\n\n### Claude Code\n\n#### Opcja A – npx (najprostsza)\n\n```bash\nclaude mcp add edu-vulcan-mcp \\\n  --env VULCAN_ALIAS=Twój_Alias \\\n  --env VULCAN_PASSWORD=Twoje_Hasło \\\n  -- npx -y github:budzikt/edu-vulcan-mcp\n```\n\n#### Opcja B – przez Marketplace (zalecana)\n\n1. **Dodaj marketplace** (tylko raz):\n    ```bash\n    claude plugin marketplace add budzikt/edu-vulcan-mcp\n    ```\n\n2. **Zainstaluj wtyczkę:**\n    ```bash\n    claude plugin install edu-vulcan-mcp@edu-vulcan-marketplace --scope local\n    ```\n\n3. **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).\n\nNa koniec zrestartuj Claude'a – `edu-vulcan-mcp` powinien być podpięty: sprawdź komendą `/mcp`\n\n---\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/budzikt/edu-vulcan-mcp\n```\n\nGemini 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.\n\n---\n\n### Lokalnie (development)\n\n```bash\ngit clone https://github.com/budzikt/edu-vulcan-mcp.git\ncd edu-vulcan-mcp\nnpm install\ncp .env.example .env\n# Wpisz swoje dane do .env\nnpm run mcp\n```\n\n---\n\n> **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ć.\n\n## Co to potrafi?\n\nNarzędzia, o użycie których możesz poprosić asystenta [kod](./mcp-server.ts):\n\n*   **`list_journal_accounts`** – Sprawdź, jakie konta uczniów (dzieci) widzę pod Twoim loginem.\n*   **`list_grades`** – \"Claude, jakie są oceny?\" i już wszystko wiesz.\n*   **`list_assignments`** – Zobacz, co tam wpadło do kalendarza (sprawdziany, zadania).\n*   **`get_assignment_details`** – Jak chcesz wiedzieć dokładnie, co trzeba zrobić w tym zadaniu z plastyki.\n*   **`list_mailboxes`** – Zobacz, jakie masz skrzynki pocztowe.\n*   **`list_messages`** – Szybki podgląd ostatnich wiadomości od wychowawcy.\n*   **`get_message_details`** – Przeczytaj całą wiadomość bez wchodzenia na stronę.\n*   **`get_messages_details_bulk`** – Pobierz kilka wiadomości naraz, żeby nie marnować czasu.\n\n\n## Konfiguracja\n\nSerwer wymaga dwóch zmiennych środowiskowych, które podajesz podczas instalacji:\n\n*   **`VULCAN_ALIAS`** – To ten krótki identyfikator, którego używasz do logowania na stronie.\n*   **`VULCAN_PASSWORD`** – Twoje hasło. Przechowywane w systemowym pęku kluczy.\n\nDane te nie są udostępniane do LLM — używane wyłącznie do uwierzytelniania przez tool call.\n\n## Lista problemów\n\n### Obecne\n\n- cała masa xD\n- 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\n- czytanie wiadomości w trybie bulk niepotrzebnie eksponuje id wiadomości i zmusza LLM do zarządzania nimi\n\n### Fixed\n- cache sesji per dziecko\n- dzielony obiekt cookie-jar pomiedzy wywołaniami per to samo dziecko\n- wydzielony flow autoryzacyjny dla tooli\n\n## Licencja\n\nISC – bierz i korzystaj!\n",
  "bytes": 4053,
  "sha": "f02dc29c671a92b1ce771d0d7df35ae1030584c621d3c1f8486cdd73ba7bfeb7",
  "repo_slug": "budzikt/edu-vulcan-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_budzikt_edu_vulcan_mcp_2bd2f857/readme"
}