Szkoly Mcp

io.github.ContentWriterco由 GitHub 帳號 ContentWriterco 發布v0.1.1更新於 Oct 24, 2026

Polish schools and kindergartens with per-school eighth-grade exam and matura results

已驗證Streamable HTTP可網頁執行位置與生活資料與分析

概覽

AI 產生的概覽

查詢波蘭中小學與幼兒園的官方名錄，並提供每所學校的八年級考試與高中畢業考成績，以及與縣、全國平均值的比較。

可以做什麼
  • 依城鎮、鄉鎮或最近地址尋找學校或幼兒園，可依學制與公立／非公立篩選，並依距離、成績或名稱排序
  • 依 RSPO 編號或名稱查看單一學校的登記資料：類型、地址、辦學機構、學生與教師人數
  • 比較某校近三年各科考試成績與所在縣及全國平均值
  • 查看資料來源、涵蓋年份與使用注意事項
適用情境
適合家長等需要比較波蘭某地區學校或幼兒園、查詢特定學校的考試成績，或在小學、liceum／technikum 之間做選擇時使用。
執行需求
可透過 szkoly.compabase.com 的 Streamable HTTP 遠端端點免登入使用，也可用 npx szkoly-mcp 在本機執行（需 Node.js）。不需 API 金鑰或帳號。本機版首次啟動會下載約 35 MB 來源資料到快取目錄，並每日更新。
安裝前請注意
僅提供唯讀查詢，不要求帳號或憑證。考試成績很大程度取決於生源，無法衡量學校的所有面向；小學入學由鄉鎮劃定的學區決定。本機執行會在磁碟寫入資料快取，若啟用也會向統計端點傳送匿名計數。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Szkoly Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.ContentWriterco%2Fszkoly-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "szkoly": {
      "type": "http",
      "url": "https://szkoly.compabase.com/mcp"
    }
  }
}

README

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.

[npm] [CI] [Licencja MIT] [Bez klucza API]

[Animacja: użytkownik pyta asystenta AI o szkoły podstawowe w gminie Kórnik; asystent korzysta z szkoly-mcp i podaje najlepsze wyniki egzaminu ósmoklasisty z polskiego, matematyki i angielskiego na tle Polski]

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:
json
{ "mcpServers": { "szkoly": { "command": "npx", "args": ["-y", "szkoly-mcp"] } } }

Co potrafi

NarzędzieDo czego
find_schoolsSzkoł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_detailsJedna 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

bash
npx -y szkoly-mcp --http --port 3000      # MCP: http://localhost:3000/mcpnpx -y szkoly-mcp find "Kórnik" --level podstawowanpx -y szkoly-mcp school 70077

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

[Animation: a user asks an AI assistant about primary schools in Kórnik; the assistant uses szkoly-mcp and answers with the best eighth-grade exam results versus Poland]

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.

來源：README.md，提交 4e7e18e

工具

3

find_schools

Find schools and kindergartens (Poland)

Schools or kindergartens in a Polish town / gmina or near an address: type, public or non-public, address, number of pupils, RSPO id, website and the latest exam results (eighth-grade exam for primary schools, matura pass rate and averages for licea/technika) vs the national average. place: town "Kórnik", gmina, address "Kraków, Długa 5" (sorted by distance) or 'lat,lon'.

輸入參數maxsortlevelplace必填radius_kmpublic_only

school_details

School details and exam results (Poland)

One school: register data (type, address, governing body, pupils, teachers, pupils per teacher) and exam results for the last years by subject – eighth-grade exam or matura (pass rate, basic and extended subjects) – compared with the county and national averages. school: RSPO number or name; town helps to disambiguate.

輸入參數townschool必填

data_sources

Data sources

Where the data comes from and caveats.

無需輸入參數。

版本歷史

2
  1. v0.1.1最新Oct 23, 2026
  2. v0.1.0Oct 22, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分