io.github.ContentWriterco/szkoly-mcp
Polish schools and kindergartens with per-school eighth-grade exam and matura results
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http szkoly-mcp 'https://szkoly.compabase.com/mcp'{
"mcpServers": {
"szkoly-mcp": {
"type": "http",
"url": "https://szkoly.compabase.com/mcp"
}
}
}szkoly-mcpclaude mcp add szkoly-mcp -- npx -y szkoly-mcp@0.1.1{
"mcpServers": {
"szkoly-mcp": {
"command": "npx",
"args": [
"-y",
"szkoly-mcp@0.1.1"
]
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
szkoly-mcp 🏫
Szkoły, przedszkola i wyniki egzaminów w Polsce – dla Twojego asystenta AI.
Serwer MCP z oficjalnym wykazem szkół i przedszkoli (MEN, SIO) oraz wynikami egzaminu ósmoklasisty i matury dla każdej szkoły (CKE). Działa w Claude, ChatGPT, Cursorze i każdym kliencie MCP.
Prawdziwa odpowiedź publicznego serwera (egzamin ósmoklasisty 2026).
Podłącz w 30 sekund
Adres MCP: https://szkoly.compabase.com/mcp (Streamable HTTP, bez logowania).
- Claude: Ustawienia → Connectors → Add custom connector → wklej adres.
- ChatGPT: Settings → Connectors (tryb deweloperski) → dodaj serwer MCP.
- Claude Code:
claude mcp add --transport http szkoly https://szkoly.compabase.com/mcp - Lokalnie (stdio):
npx -y szkoly-mcp, np. w Claude Desktop:
{ "mcpServers": { "szkoly": { "command": "npx", "args": ["-y", "szkoly-mcp"] } } }Co potrafi
| Narzędzie | Do czego |
|---|---|
find_schools | Szkoły albo przedszkola w miejscowości, gminie lub najbliżej adresu (z odległością): typ, publiczna/niepubliczna, specyfika (np. specjalna, sportowa), adres, liczba uczniów, strona www, numer RSPO i najnowsze wyniki egzaminu na tle Polski – egzamin ósmoklasisty dla podstawówek, zdawalność i średnie z matury dla liceów i techników. Sortowanie po odległości, wynikach albo nazwie; filtr „tylko publiczne”. |
school_details | Jedna szkoła (po numerze RSPO albo nazwie): dane z rejestru, organ prowadzący, liczba uczniów i nauczycieli, wyniki z ostatnich 3 lat z każdego przedmiotu na tle powiatu i kraju – egzamin ósmoklasisty albo matura (zdawalność, przedmioty podstawowe i rozszerzone). |
data_sources | Źródła, roczniki danych i zastrzeżenia. |
Przykładowe pytania: „Jakie podstawówki są najbliżej ul. Garbary 10 w Poznaniu?”, „Najlepsze licea w Poznaniu wg matury”, „Porównaj SP 1 i SP 2 w Kórniku”, „Jakie przedszkola są w gminie Swarzędz?”, „Jak technikum w Bolesławcu wypada z matematyki na maturze?”.
Skąd dane
- Wykaz szkół i placówek oświatowych – MEN, System Informacji Oświatowej (stan na 30 września), dane.gov.pl, CC BY 4.0: ok. 42 tys. szkół i przedszkoli z adresem, typem, organem prowadzącym, liczbą uczniów i nauczycieli.
- Wyniki egzaminów – Centralna Komisja Egzaminacyjna, Mapa wyników egzaminów: egzamin ósmoklasisty i matura (formuła 2023) z ostatnich 3 lat, dla każdej szkoły (średnie pokazywane od 5 zdających). Średnie powiatu i kraju liczymy z wyników szkół (ważone liczbą zdających).
- Odległości – adresy szkół geokodowane państwowym rejestrem adresów GUGiK.
- Dane pobierają się przy pierwszym uruchomieniu (~35 MB plików źródłowych, zapisywane jako ~35 MB JSON w
~/.cache/szkoly-mcp) i są sprawdzane raz na dobę. - Zastrzeżenia: wynik egzaminu zależy w dużej mierze od tego, jacy uczniowie trafiają do szkoły, i nie mierzy wszystkiego, co w niej ważne. O przyjęciu do szkoły podstawowej decyduje obwód (rejon) ustalony przez gminę.
Własny serwer
npx -y szkoly-mcp --http --port 3000 # MCP: http://localhost:3000/mcp
npx -y szkoly-mcp find "Kórnik" --level podstawowa
npx -y szkoly-mcp school 70077Zmienne: SZKOLY_DATA_DIR, SZKOLY_REFRESH_HOURS (24), SZKOLY_E8_YEARS / SZKOLY_MATURA_YEARS (3), SZKOLY_RATE_LIMIT, SZKOLY_STATS=1 (anonimowe liczniki pod /stats), SZKOLY_CONTACT, SZKOLY_PUBLIC_URL.
Licencja
Kod: MIT. Dane: MEN (SIO, dane.gov.pl, CC BY 4.0), CKE (Mapa wyników egzaminów), GUGiK – dane przetworzone. Projekt niezależny, hostowany pro publico bono przez Compabase. Zobacz też rozkład-mcp, ceny-nieruchomosci-mcp, leki-mcp i powietrze-mcp.
English
szkoly-mcp gives AI assistants the official register of Polish schools and kindergartens (Ministry of Education, SIO) with pupils, teachers and addresses, plus per-school exam results – the eighth-grade exam (egzamin ósmoklasisty) and the matura – for the last three years by subject, compared with county and national averages. Find schools in a town, gmina or near an address (with distances). Public endpoint: https://szkoly.compabase.com/mcp (no key), or run locally with npx -y szkoly-mcp.
Questions fréquentes
Qu'est-ce que io.github.ContentWriterco/szkoly-mcp ?
Polish schools and kindergartens with per-school eighth-grade exam and matura results
Comment installer io.github.ContentWriterco/szkoly-mcp ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http szkoly-mcp 'https://szkoly.compabase.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.ContentWriterco/szkoly-mcp ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.ContentWriterco/szkoly-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.ContentWriterco/szkoly-mcp ?
Il est publié par ContentWriterco. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.