Edu Data MCP Server

🚀 教育数据 MCP 服务器

本项目提供了一个 MCP（模型上下文协议）服务器，可助力用户轻松访问城市研究所的教育数据 API。该服务器专为搭配 Claude 使用而设计，让教育数据的获取变得轻而易举。

🚀 快速开始

本服务器旨在与 Claude 协同工作，帮助你便捷地访问城市研究所的教育数据 API。按以下步骤操作，即可快速开启数据探索之旅：

1. 克隆此仓库：

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

2. 安装依赖项：

   npm install
   

3. 配置 MCP 服务器（示例见后续配置章节）
4. 启动服务器：

   npm start
   

✨ 主要特性

• 借助 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

📚 详细文档

仓库结构

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

关于教育数据 API

城市研究所的 教育数据 API 提供了丰富的教育资源数据，涵盖内容如下：

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

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

配置 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 许可证。