szkoly-mcp

Name: szkoly-mcp
Author: ContentWriterco

远程服务

github.com/ContentWriterco科研与教育05 天前更新

代码仓库

关于 szkoly-mcp

szkoly-mcp 是面向 AI 助手的 MCP 服务，提供波兰学校和幼儿园信息。它结合官方教育名录与学校级八年级考试和高中毕业考试成绩，并支持按位置查找和成绩比较。

主要功能

01按地区搜索学校和幼儿园
02按距离查找附近学校
03查看学生和教师人数
04比较近三年考试成绩
05查询数据来源和覆盖范围

适用场景

01查找指定地址附近的学校
02按考试成绩比较当地学校
03查询某个市镇的幼儿园

MCP 相关

向 MCP 客户端提供学校搜索、学校详情和数据来源查询工具。可连接托管端点，也可通过 stdio 在本地运行。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://szkoly.compabase.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http contentwriterco-szkoly https://szkoly.compabase.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"contentwriterco-szkoly":{"type":"http","url":"https://szkoly.compabase.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"contentwriterco-szkoly":{"type":"http","url":"https://szkoly.compabase.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"contentwriterco-szkoly":{"type":"http","url":"https://szkoly.compabase.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"contentwriterco-szkoly":{"serverUrl":"https://szkoly.compabase.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npmszkoly-mcp0.1.1stdio

工具

详细介绍

szkoly-mcp 🏫

学校、幼儿园和波兰考试成绩——为你的 AI 助手提供。
一个 MCP 服务，提供官方学校和幼儿园名录（MEN、SIO），以及每所学校的八年级考试和高中毕业考试成绩（CKE）。可在 Claude、ChatGPT、Cursor 和所有 MCP 客户端中使用。

动画：用户向 AI 助手询问科尔尼克市镇的公立小学；助手使用 szkoly-mcp，提供八年级考试波兰语、数学和英语成绩高于波兰全国水平的学校

_{公共服务的真实回答（2026 年八年级考试）。}

30 秒内完成连接

MCP 地址：https://szkoly.compabase.com/mcp（Streamable HTTP，无需登录）。

**Claude：**设置 → Connectors → Add custom connector → 粘贴地址。
**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 编号，以及最新考试成绩与波兰全国水平的对比——小学的八年级考试成绩，以及高中和技术学校的高中毕业考试通过率和平均分。可按距离、成绩或名称排序；筛选“仅公立”。
`school_details`	查询一所学校（按 RSPO 编号或名称）：注册信息、主管机构、学生和教师人数、最近 3 年各科成绩与县和全国水平的对比——八年级考试或高中毕业考试（通过率、基础科目和进阶科目）。
`data_sources`	数据来源、数据年份和注意事项。

示例问题：“波兹南 Garbary 街 10 号附近有哪些小学？”，“波兹南高中毕业考试成绩最好的高中有哪些？”，“比较科尔尼克的 SP 1 和 SP 2”，“斯瓦任兹市镇有哪些幼儿园？”，“博莱斯瓦维茨的技术学校高中毕业考试数学成绩如何？”。

数据来源

学校和教育机构名录——MEN，教育信息系统（截至 9 月 30 日），data.gov.pl，CC BY 4.0：约 4.2 万所学校和幼儿园，包含地址、类型、主管机构、学生和教师人数。
考试成绩——中央考试委员会，考试成绩地图：每所学校最近 3 年的八年级考试和高中毕业考试（2023 年考试形式）成绩（至少有 5 名考生才显示平均分）。县和全国平均分根据学校成绩计算，并按考生人数加权。
距离——学校地址使用 GUGiK 国家地址登记系统进行地理编码。
数据会在首次运行时下载（约 35 MB 源文件，存储为 ~/.cache/szkoly-mcp 中约 35 MB 的 JSON），并每天检查一次。
**注意事项：**考试成绩在很大程度上取决于就读学校的学生情况，无法衡量学校所有重要方面。小学录取由市镇划定的学区决定。

自托管服务

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。

英文

动画：用户向 AI 助手询问科尔尼克的小学；助手使用 szkoly-mcp，并回答其八年级考试成绩相对于波兰全国的排名

szkoly-mcp 为 AI 助手提供波兰学校和幼儿园官方名录（教育部、SIO），包含学生、教师和地址信息，以及各校考试成绩——过去三年的八年级考试（egzamin ósmoklasisty）和高中毕业考试（matura）各科成绩，并与县级和全国平均水平进行比较。可按城镇、市镇或地址附近查找学校（包含距离）。公共端点：https://szkoly.compabase.com/mcp（无需密钥），也可以使用 npx -y szkoly-mcp 在本地运行。