szkoly-mcp

szkoly-mcp 🏫

ポーランドの学校、幼稚園、試験結果を、AI アシスタントに。
公式の学校・幼稚園一覧（MEN、SIO）と、各学校の8年生修了試験および大学入学資格試験の結果（CKE）を提供するMCP サーバーです。Claude、ChatGPT、Cursor、およびあらゆるMCPクライアントで動作します。

_{公開サーバーからの実際の回答（2026年の8年生修了試験）。}

30秒で接続

MCPアドレス：https://szkoly.compabase.com/mcp（ストリーミング可能なHTTP、ログイン不要）。

• Claude： 設定 → コネクター → カスタムコネクターを追加 → アドレスを貼り付けます。
• ChatGPT： Settings → Connectors（開発者モード）→ MCPサーバーを追加します。
• Claude Code： claude mcp add --transport http szkoly https://szkoly.compabase.com/mcp
• ローカル（stdio）： npx -y szkoly-mcp。たとえばClaude Desktopでは次のようにします。

{ "mcpServers": { "szkoly": { "command": "npx", "args": ["-y", "szkoly-mcp"] } } }

できること

ツール	用途
find_schools	市町村、自治体、または住所から最寄り（距離付き）の学校や幼稚園を検索します。種類、公立／私立、特色（例：特別支援、スポーツ）、住所、生徒数、ウェブサイト、RSPO番号、ポーランド全体と比較した最新の試験結果を表示します。小学校は8年生修了試験、リセウムとテクニクムは大学入学資格試験の合格率と平均点が対象です。距離、成績、または名称順に並べ替えられます。「公立のみ」フィルターもあります。
school_details	1校の情報を表示します（RSPO番号または名称で検索）。登録情報、設置者、生徒数と教員数、郡および国内の結果と比較した過去3年間の各科目の結果を確認できます。8年生修了試験または大学入学資格試験（合格率、必修科目、発展科目）が対象です。
data_sources	データソース、データの年度、注意事項を表示します。

質問の例：「ポズナンのガルバリ通り10番地に最も近い小学校は？」「大学入学資格試験の成績で選ぶポズナンの優秀なリセウム」「コルニクのSP 1とSP 2を比較して」「スヴァジェンツ自治体にはどんな幼稚園がある？」「ボレスワヴィエツのテクニクムは大学入学資格試験の数学でどのくらいの成績？」

データの出所

• 学校・教育機関一覧 – MEN、教育情報システム（9月30日時点）、dane.gov.pl、CC BY 4.0：住所、種類、設置者、生徒数、教員数を含む約4万2千校の学校・幼稚園。
• 試験結果 – 中央試験委員会、試験結果マップ：過去3年間の8年生修了試験と大学入学資格試験（2023年方式）の、各学校の結果（受験者が5人以上の場合に平均点を表示）。郡および国内の平均点は学校の結果をもとに算出し、受験者数で加重しています。
• 距離 – 学校の住所をGUGiKの国の住所登録簿でジオコーディングしています。
• データは初回起動時にダウンロードされます（ソースファイル約35 MB、~/.cache/szkoly-mcpに約35 MBのJSONとして保存）。1日1回確認されます。
• 注意事項： 試験結果は、どのような生徒がその学校に入学するかに大きく左右され、学校にとって重要なすべてを測るものではありません。小学校への入学は、自治体が定める学区によって決まります。

独自サーバー

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 70077

変数：SZKOLY_DATA_DIR、SZKOLY_REFRESH_HOURS（24）、SZKOLY_E8_YEARS / SZKOLY_MATURA_YEARS（3）、SZKOLY_RATE_LIMIT、SZKOLY_STATS=1（/stats で匿名カウンターを表示）、SZKOLY_CONTACT、SZKOLY_PUBLIC_URL。

ライセンス

コード：MIT。データ：MEN（SIO、dane.gov.pl、CC BY 4.0）、CKE（試験結果マップ）、GUGiK ― 加工済みデータ。独立したプロジェクトで、Compabase が公益目的でホスティングしています。rozkład-mcp、ceny-nieruchomosci-mcp、leki-mcp、powietrze-mcp もご覧ください。

---

English

szkoly-mcp は、ポーランドの学校・幼稚園の公式登録簿（教育省、SIO）と、児童・生徒数、教員数、住所をAIアシスタントに提供します。さらに、学校ごとの試験結果として、過去3年間の教科別8年生試験（egzamin ósmoklasisty）とマトゥーラの結果を、郡および全国の平均と比較して提供します。町、基礎自治体、または住所周辺の学校を、距離付きで検索できます。公開エンドポイントは https://szkoly.compabase.com/mcp（キー不要）です。または、npx -y szkoly-mcp でローカル実行できます。