> 🇨🇭 部分 瑞士公共数据MCP投资组合
📊 zh-教育mcp
> 苏黎世州和市教育统计MCP服务器(BISTA)
🇩🇪 德语版
概述
zh-education-mcp 将AI助手连接到 苏黎世州教育统计局(BISTA) --苏黎世州的官方教育统计数据。它提供了对学生人数、学区趋势、中学概况、国籍分类和体育馆毕业率的结构化访问。
| 来源 | 数据 | API |
|---|---|---|
| BISTA 苏黎世 州 | 学习者统计(小学、中学、成熟度) | REST/CSV |
所有数据均从 BISTA公共API (bista.zh.ch/basicapi/ogd/)-不需要API密钥。每年9月15日(参考日期)更新数据。
锚点演示查询: “在过去的5年里,莱茨学区的学生人数是如何发展的?”
演示
特性
- 📊 8工具 用于所有学校级别的教育数据
- 🔍 学区趋势 --2000年至今,所有Schulkreise(莱茨、格拉塔尔、施瓦门丁根、欧瑞康、乌托、魏德伯格、苏黎世)的学生人数
- 🏫 中学简介 --按需求类型细分(Sek A/B/C、Mittelschule、特殊类别)
- 🌐 国籍结构 --每个学校社区学生的主要国籍
- 🎓 体育馆毕业率 --按市、区和州分列的Maturitätsquote
- 📈 全国概况 --按学校级别、类型、性别和国籍列出的所有学习者
- 🏠 基于住宅的趋势 --按居住地统计的学生人数(Bezirk/Gemeinde)
- 🏛️ 中学 --体育馆、FMS、HMS统计
- 🔓 不需要API密钥 --CC BY 4.0下的所有数据
- ☁️ 双重运输 --stdio(克劳德桌面)+流式HTTP(云)
先决条件
- Python 3.11+
- 紫外线 (推荐)或pip
安装```bash
Clone the repository
git clone https://github.com/malkreide/zh-education-mcp.git
cd zh-education-mcp
Install
pip install -e .
or with uv:
uv pip install -e .
或与 `uvx` (无永久性安装):```bash
uvx zh-education-mcp
快速入门```bash
stdio (for Claude Desktop)
python -m zh_education_mcp.server
Streamable HTTP (port 8000)
python -m zh_education_mcp.server --http --port 8000
立即在Claude Desktop中尝试:
> *“莱齐学区的学生人数如何发展?”*
> *“显示苏黎世市的成熟率”*
> *“哪些民族在阿德利斯维尔最常见?”*
→ 按受众划分的更多用例 →
______________________________________________________________________
## 配置
### 克劳德桌面版
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)或 `%APPDATA%\Claude\claude_desktop_config.json` (Windows):```json
{
"mcpServers": {
"zh-education": {
"command": "python",
"args": ["-m", "zh_education_mcp.server"]
}
}
}
或与 uvx:```json
{
"mcpServers": {
"zh-education": {
"command": "uvx",
"args": ["zh-education-mcp"]
}
}
}
**配置文件位置:**
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- 窗户: `%APPDATA%\Claude\claude_desktop_config.json`
### 云部署(SSE用于浏览器访问)
通过以下方式使用 **浏览器中的claude.ai** (例如,在没有本地软件的受管工作站上):
**Render.com(推荐):**
1. 将存储库推/叉到GitHub
1. 开 render.com:新Web服务→ 连接GitHub仓库
1. 设置启动命令: `python -m zh_education_mcp.server --http --port 8000`
1. 在claude.ai的设置下→ MCP服务器,添加: `https://your-app.onrender.com/sse`
> 💡 *“stdio用于开发人员笔记本电脑,SSE用于浏览器。”*
______________________________________________________________________
## 可用工具
工具 · 说明
`zh_edu_list_schulgemeinden` · 列出苏黎世州的所有学校社区/Schulkreise
`zh_edu_schulkreis_trend` · Schulkreis的学生趋势(2000年至今)
`zh_edu_overview` · 按学校级别划分的全国学生概况
`zh_edu_sek1_profil` · 中学一年级概况(Sek A/B/C细分)
`zh_edu_staatsangehoerigkeiten` · 每个学校社区学生的国籍结构
`zh_edu_maturitaetsquote` · 按市/区分列的体育馆毕业率
`zh_edu_wohnort_trend` 基于居住地的学习趋势(地区/社区)
`zh_edu_mittelschulen` · 中学统计(体育馆、FMS、HMS)
### 示例用例
|查询|工具|
|-------|------|
| *“列出苏黎世的所有Schulkreise”* | `zh_edu_list_schulgemeinden` |
| *“乐子5年来的学生趋势”* | `zh_edu_schulkreis_trend` |
| *“温特图尔有多少Sek A vs Sek B?”* | `zh_edu_sek1_profil` |
| *“苏黎世莱茨的顶级民族”* | `zh_edu_staatsangehoerigkeiten` |
| *“苏黎世市的成熟率”* | `zh_edu_maturitaetsquote` |
______________________________________________________________________
## 建筑```
┌─────────────────┐ ┌──────────────────────────────┐ ┌──────────────────────────┐
│ Claude / AI │────▶│ zh-education-mcp │────▶│ BISTA Kanton Zürich │
│ (MCP Host) │◀────│ (MCP Server) │◀────│ REST/CSV (Public API) │
└─────────────────┘ │ │ └──────────────────────────┘
│ 8 Tools │
│ Stdio | Streamable HTTP │
│ 24h Cache │
│ No authentication required │
└──────────────────────────────┘
数据源特征
| 来源 | 协议 | 覆盖范围 | 授权 | 更新 |
|---|---|---|---|---|
| BISTA Kanton ZH | REST/CSV | 2000年至今的学习者统计数据 | 无 | 年度(9月15日) |
项目结构```
zh-education-mcp/
├── src/zh_education_mcp/
│ ├── init.py # Package
│ └── server.py # 8 tools, cache, dual transport
├── tests/
│ └── test_server.py # Unit tests (mocked HTTP with respx)
├── .github/workflows/ci.yml # GitHub Actions (Python 3.11/3.12/3.13)
├── pyproject.toml
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md # This file (English)
└── README.de.md # German version
______________________________________________________________________
## 已知限制
- **仅限年度更新:** BISTA数据每年更新一次(参考日期:9月15日)。24小时内存缓存与此周期匹配。
- **基于CSV的API:** BISTA API返回CSV数据;大型数据集可能需要一些时间来解析。
- **学校社区名称:** 名称必须完全匹配(使用 `zh_edu_list_schulgemeinden` 查找有效名称)。
______________________________________________________________________
## 安全与限制
|主题|详细信息|
|-------|---------|
| **无个人数据** |BISTA统计数据是汇总的,没有单独的学生数据被公开或访问。所有数据在学校社区层面都是匿名的。 |
| **只读** |所有工具都是只读的(`readOnlyHint: true`).服务器无法修改、删除或写入任何数据。 |
| **无身份验证** |BISTA API是完全公开的。没有存储或传输API密钥、令牌或凭证。 |
| **费率限制** |BISTA API没有记录速率限制,但服务器使用24小时内存缓存来最大限度地减少请求。请负责任地使用。 |
| **数据授权** |所有数据均发布在 CC 4.0 苏黎世州。归因: *苏黎世州教育统计局(BISTA)*. |
| **服务条款** |使用受 BISTA使用条款MCP服务器是一个独立的开源项目,不隶属于苏黎世州。 |
| **AI输出免责声明** |统计数据通过BISTA API的as-is传递。人工智能生成的解释或总结应与 BISTA官方门户. |
______________________________________________________________________
## 测试```bash
# Unit tests (no API calls)
PYTHONPATH=src pytest tests/ -m "not live"
# Integration tests (live API calls)
pytest tests/ -m "live"
更新日志
看 更改日志.md
贡献
看 贡献.md
许可证
MIT许可证——见 许可证
作者
Hayal Oezkan· 马尔克雷德
学分及相关项目
- BISTA: pub.bista.zh.ch — 苏黎世州教育统计 (CC BY 4.0)
- 协议: 模型上下文协议 --Anthropic/Linux基金会
- 相关: 苏黎世开放数据mcp --苏黎世市开放数据(停车、天气、议会)
- 相关: 瑞士文化遗产 --瑞士文化遗产数据
- 相关: fedlex mcp --瑞士联邦法律
- 文件夹: 瑞士公共数据MCP投资组合
