Education Data MCP Server

教育数据 MCP 服务

此代码库包含一个 MCP（Model Context Protocol）服务，可访问 Urban Institute 的 Education Data API。该服务旨在与 Claude 配合使用，以便轻松访问教育数据。

代码库结构

• education-data-package-r/：用于访问 Education Data API 的原始 R 包（供参考）
• src/：MCP 服务源代码
• build/：编译后的 MCP 服务

关于 Education Data API

Urban Institute 的 Education Data API 提供丰富的教育数据，包括：

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

该 API 按级别（schools、school-districts、college-university）、来源（ccd、ipeds、crdc 等）和主题（enrollment、directory、finance 等）组织。

功能

• 通过 get_education_data 工具检索详细的教育数据
• 通过 get_education_data_summary 工具检索汇总后的教育数据
• 通过资源浏览可用的端点

安装

1. 克隆此代码库：

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

2. 安装依赖项：

   npm install
   

3. 构建服务：

   npm run build
   

4. 使服务可通过 npx 使用：

   npm link
   

配置 MCP 服务

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

适用于 Claude Desktop App（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 访问教育数据：

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