内容
# IDEB MCP
连接 Claude 到 **IDEB**（基础教育发展指数）的数据库，直接在对话中查询任何巴西城市的教育绩效。
涵盖 10 个评估周期（2005 年至 2023 年），涉及约 5,570 个城市，覆盖州、市和公立教育网络，包括观测到的 IDEB、预期目标、数学和葡萄牙语成绩以及学校流动指标。
来自 INEP/MEC 的公共数据。
---
## 你可以问
<!-- INSERIR PRINT: conversa mostrando ranking de municípios de SP -->
<!-- INSERIR PRINT: conversa mostrando série histórica de um município -->
<!-- INSERIR PRINT: conversa comparando dois municípios -->
---
## 可用阶段
| 阶段 | 描述 |
|-------|-----------|
| 初级阶段 | 基础教育 — 1 至 5 年级 |
| 高级阶段 | 基础教育 — 6 至 9 年级 |
| 中学阶段 | 中学阶段 |
---
## 安装步骤
### 1. 安装 Python
访问 https://www.python.org/downloads 并下载最新版本。
> **Windows:** 在安装过程中，勾选 **"Add Python to PATH"** 选项，然后点击 Install。
要验证安装是否成功，请打开终端并输入：
```bash
python --version
```
### 2. 安装 Git
访问 https://git-scm.com/downloads 并为您的系统安装 Git。
要验证：
```bash
git --version
```
### 3. 安装 Git LFS
IDEB 数据库约为 75MB，并通过 Git LFS（Large File Storage）存储。访问 https://git-lfs.com 并安装。
要验证：
```bash
git lfs version
```
### 4. 克隆仓库
打开终端并运行：
```bash
git lfs install
git clone https://github.com/rafaelcamelo/ideb-mcp.git
cd ideb-mcp
```
### 5. 安装包
```bash
pip install -e .
```
---
## 在 Claude Desktop 上配置
> 没有 Claude Desktop？请在 https://claude.ai/download 下载
**1.** 打开 Claude Desktop 配置文件：
- **Windows:** 按 `Win + R` ，输入 `%APPDATA%\Claude` ，然后打开 `claude_desktop_config.json` 文件
- **macOS:** 打开 Finder，按 `Cmd + Shift + G` ，粘贴 `~/Library/Application Support/Claude` ，然后打开 `claude_desktop_config.json` 文件
如果文件不存在，请创建它。
**2.** 将 IDEB 服务器添加到 JSON 中。如果文件为空，请粘贴以下内容：
```json
{
"mcpServers": {
"ideb": {
"command": "python",
"args": ["-m", "ideb_mcp"]
}
}
}
```
如果文件已有内容，请仅在 `"mcpServers"` 中添加 `"ideb"` 块：
```json
{
"mcpServers": {
"ideb": {
"command": "python",
"args": ["-m", "ideb_mcp"]
}
}
}
```
> **Windows:** 如果 Claude 找不到 Python，请将 `"python"` 替换为完整路径。要找到路径，请打开终端并运行 `where.exe python`。结果将类似于 `C:\Users\SEU_USUARIO\AppData\Local\Programs\Python\Python312\python.exe` — 在 `"python"` 处使用此值。
**3.** 保存文件并 **完全重启 Claude Desktop** （通过系统托盘图标关闭，而不是仅关闭窗口）。
**4.** 打开新对话并提问，例如：
> "2023 年 Campinas 的 IDEB 是多少？"
---
## 其他兼容客户端
MCP 协议除 Claude Desktop 外还被其他客户端支持。配置有所不同 — 请参阅每个客户端的文档：
- **[Cursor](https://cursor.com)** — 带有 AI 的代码编辑器
- **[Zed](https://zed.dev)** — 带有 AI 的代码编辑器
- **[Continue](https://continue.dev)** — VS Code 和 JetBrains 扩展
> **ChatGPT 和 Gemini** 不原生支持 MCP 协议。
---
## 提问示例
**按城市查询：**
- "Ariquemes（RO）初级阶段的 IDEB 是多少？"
- "Campinas 的 IDEB 从 2005 年到 2023 年如何演变？"
- "2023 年 São Paulo 初级阶段的数学成绩是多少？"
**排名：**
- "MG 中学阶段 IDEB 排名前 10 的城市有哪些？"
- "2023 年 SC 初级阶段 IDEB 最差的城市是哪个？"
**比较：**
- "比较 Curitiba 和 Londrina 的初级阶段 IDEB"
- "2005 年至 2023 年间，Recife 和 Fortaleza 哪个增长更多？"
**概览：**
- "2023 年巴西初级阶段的平均 IDEB 是多少？"
- "哪个州的中学阶段 IDEB 平均分最高？"
---
## 数据来源
从 INEP/MEC 在 https://www.gov.br/inep/pt-br/areas-de-atuacao/avaliacao-e-exames-educacionais/ideb/resultados 提供的市级 IDEB 结果公开表格中提取。
---
## 许可证
代码遵循 MIT 许可证。IDEB 数据为公共数据（INEP/MEC）。
