Zh Education MCP

MCP数据服务

提供方 malkreide

数据服务 stdio · 本地进程 无需鉴权 官方维护 Claude DesktopClaude
查看接入方式

zh-education-mcp 是一个连接AI助手与苏黎世州教育局官方统计数据的工具,提供对学校区域趋势、中学概况、国籍结构等教育数据的结构化访问。

一句话选型结论

按资料字段整理

Zh Education MCP 属于数据服务类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 官方维护 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

教育统计Python本地部署数据查询AI接口公开数据学校分析

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zh Education MCP当前 8 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方malkreide上游标注的维护方 malkreide
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方官方维护核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.4 KB
来自项目仓库与上游目录的原文,未做删改

> 🇨🇭 部分 瑞士公共数据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投资组合

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Zh Education MCP 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

Zh Education MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Zh Education MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zh Education MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zh Education MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Zh Education MCP 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 Python、Claude、数据分析。具体工具清单以官方文档为准。

Zh Education MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Zh Education MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。