MCP 服务器

Education Data MCP Server

通过 Claude 提供对城市研究所教育数据 API 的访问，使用户能够查询和分析来自学校、学区和大学的详细教育数据。

README

教育数据 MCP 服务器

此仓库包含一个 MCP (模型上下文协议) 服务器，用于访问 Urban Institute 的教育数据 API。该服务器旨在与 Claude 配合使用，以方便访问教育数据。

仓库结构

education-data-package-r/: 用于访问教育数据 API 的原始 R 包（供参考）
src/: MCP 服务器源代码
build/: 编译后的 MCP 服务器

关于教育数据 API

Urban Institute 的教育数据 API 提供了对各种教育数据的访问，包括：

学校和学区入学数据
大学数据
评估数据
财务数据
以及更多

该 API 按级别（学校、学区、大学）、来源（ccd、ipeds、crdc 等）和主题（入学、目录、财务等）组织。

功能

通过 get_education_data 工具检索详细的教育数据
通过 get_education_data_summary 工具检索聚合的教育数据
通过资源浏览可用的端点

安装

克隆此仓库：

git clone https://github.com/yourusername/edu-data-mcp-server.git
cd edu-data-mcp-server

安装依赖项：
```
npm install
```
构建服务器：
```
npm run build
```
使服务器可用于 npx：
```
npm link
```

配置 MCP 服务器

要将此 MCP 服务器与 Claude 配合使用，您需要将其添加到您的 MCP 设置配置文件中。

对于 Claude 桌面应用程序 (macOS)

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "edu-data": {
      "command": "npx",
      "args": ["edu-data-mcp-server"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

对于 VSCode 中的 Claude

编辑 /home/codespace/.vscode-remote/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "edu-data": {
      "command": "npx",
      "args": ["edu-data-mcp-server"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

可用工具

get_education_data

从 API 检索详细的教育数据。

参数：

level (必需): 要查询的 API 数据级别（例如，“schools”、“school-districts”、“college-university”）
source (必需): 要查询的 API 数据源（例如，“ccd”、“ipeds”、“crdc”）
topic (必需): 要查询的 API 数据主题（例如，“enrollment”、“directory”）
subtopic (可选): 分组参数列表（例如，[“race”, “sex”]）
filters (可选): 查询过滤器（例如，{year: 2008, grade: [9,10,11,12]}）
add_labels (可选): 在适用时添加变量标签（默认值：false）
limit (可选): 限制结果数量（默认值：100）

示例：

{
  "level": "schools",
  "source": "ccd",
  "topic": "enrollment",
  "subtopic": ["race", "sex"],
  "filters": {
    "year": 2008,
    "grade": [9, 10, 11, 12]
  },
  "add_labels": true,
  "limit": 50
}

get_education_data_summary

从 API 检索聚合的教育数据。

参数：

level (必需): 要查询的 API 数据级别
source (必需): 要查询的 API 数据源
topic (必需): 要查询的 API 数据主题
subtopic (可选): 附加参数（仅适用于某些端点）
stat (必需): 要计算的汇总统计量（例如，“sum”、“avg”、“count”、“median”）
var (必需): 要汇总的变量
by (必需): 用于对结果进行分组的变量
filters (可选): 查询过滤器

示例：

{
  "level": "schools",
  "source": "ccd",
  "topic": "enrollment",
  "stat": "sum",
  "var": "enrollment",
  "by": ["fips"],
  "filters": {
    "fips": [6, 7, 8],
    "year": [2004, 2005]
  }
}

可用资源

该服务器提供用于浏览可用端点的资源：

edu-data://endpoints/{level}/{source}/{topic}: 有关特定教育数据端点的信息

与 Claude 的示例用法

配置 MCP 服务器后，您可以将其与 Claude 配合使用以访问教育数据：

你能给我展示一下 2020 年加利福尼亚州高中的入学数据吗？

然后，Claude 可以使用 MCP 服务器来检索和分析数据：

use_mcp_tool
server_name: edu-data
tool_name: get_education_data
arguments: {
  "level": "schools",
  "source": "ccd",
  "topic": "enrollment",
  "filters": {
    "year": 2020,
    "fips": 6,
    "grade": [9, 10, 11, 12]
  },
  "limit": 10
}