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 分