ckz

@ckz/edu_data_mcp_server

0 Stars 300 次浏览 ckz 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

教育数据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：

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：

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）

示例：
json
{
"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（可选）：查询过滤器

示例：
json
{
"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

许可证

MIT

查看源码项目主页