教育数据 MCP 服务器

此仓库包含一个 MCP（模型上下文协议）服务器，该服务器提供对城市研究所教育数据 API 的访问。此服务器专为与Claude一起使用而设计，以实现轻松访问教育数据。

仓库结构

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

关于教育数据 API

城市研究所的 教育数据 API 提供了大量教育资源数据，包括：

• 学校和学区注册人数数据
• 大专院校数据
• 测评数据
• 财务数据
• 以及其他更多内容

该 API 按级别（学校、学校学区、大专院校）、来源（ccd、ipeds、crdc 等）和主题（注册人数、目录、财务等）进行组织。

特性

• 使用 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
   

配置 MCP 服务器

在 macOS 上配置：

{
  "name": "edu-data",
  "version": "1.0.0",
  "description": "教育数据 MCP 服务器",
  "main": "build/index.js",
  "scripts": {
    "start": "node build/index.js"
  },
  "dependencies": {
    "@urban-institute/education-data-api": "^1.0.0"
  }
}

在 VSCode 上配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "教育数据 MCP 服务器",
      "type": "node",
      "request": "launch",
      "program": "${file}",
      "args": []
    }
  ]
}

可用资源

服务器提供以下资源用于浏览可用端点：

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

示例使用与 Claude

配置完成后，可以使用 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
}

开发

直接运行服务器：

npm start

在开发期间使用观察模式：

npm run watch

检查服务器功能：

npm run inspector

通过 npx 运行服务器：

npx edu-data-mcp-server

许可证

MIT