教育数据MCP服务器

此存储库包含一个 MCP（模型上下文协议）服务器，用于访问城市研究所的教育数据 API。该服务器旨在与 Claude 配合使用，以便轻松访问教育数据。

存储库结构

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

关于教育数据 API

城市研究所的教育数据 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": []
    }
  }
}

可用工具

获取教育数据

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

参数：

level （必需）：要查询的 API 数据级别（例如，“学校”、“学区”、“大学”）
source （必需）：要查询的 API 数据源（例如，'ccd'、'ipeds'、'crdc'）
topic （必需）：要查询的 API 数据主题（例如，“注册”、“目录”）
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
}

获取教育数据摘要

从 API 中检索汇总的教育数据。

参数：

level （必需）：要查询的 API 数据级别
source （必需）：要查询的 API 数据源
topic （必填）：需要查询的API数据主题
subtopic （可选）：附加参数（仅适用于某些端点）
stat （必需）：要计算的汇总统计数据（例如，“总和”、“平均值”、“计数”、“中位数”）
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 访问教育数据：

Can you show me the enrollment data for high schools in California for 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
}

发展

直接运行服务器：

npm start

要在开发期间以监视模式运行服务器：

npm run watch

检查服务器的功能：

npm run inspector

要使用 npx 运行服务器：

npx edu-data-mcp-server

执照

麻省理工学院

Education Data MCP Server

Integrations