🚀 教育数据 MCP 服务器
本项目提供了一个 MCP（模型上下文协议）服务器，可助力用户轻松访问城市研究所的教育数据 API。该服务器专为搭配 Claude 使用而设计，让教育数据的获取变得轻而易举。
🚀 快速开始
本服务器旨在与 Claude 协同工作，帮助你便捷地访问城市研究所的教育数据 API。按以下步骤操作，即可快速开启数据探索之旅：
- 克隆此仓库：
git clone https://github.com/yourusername/edu-data-mcp-server.git cd edu-data-mcp-server - 安装依赖项：
npm install - 配置 MCP 服务器（示例见后续配置章节）
- 启动服务器：
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 许可证。