教育数据MCP服务器
该存储库包含一个MCP（模型上下文协议）服务器，用于访问城市研究所的教育数据API。该服务器旨在与Claude一起使用，以便轻松访问教育数据。
存储库结构
education-data-package-r/：用于访问教育数据API的原始R包（供参考）src/：MCP服务器源代码build/：编译的MCP服务器
关于教育数据API
城市研究所 教育数据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:
{
"mcpServers": {
"edu-data": {
"command": "npx",
"args": ["edu-data-mcp-server"],
"disabled": false,
"alwaysAllow": []
}
}
}对于VSCode中的克劳德
编辑 /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": []
}
}
}可用工具
获取教育数据
从API检索详细的教育数据。
参数：
level（必需）：要查询的API数据级别（例如“学校”、“学校限制”、“大学-大学”）source（必需）：要查询的API数据源（例如，“ccd”、“ipeds”、“crdc”）topic（必需）：要查询的API数据主题（例如，“注册”、“目录”）subtopic（可选）：分组参数列表（例如，\[“空间”、“性别”\]）filters（可选）：查询筛选器（例如，{年份：2008，年级：\[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（必填）：要计算的汇总统计数据（例如，“总和”、“平均值”、“计数”、“中位数”）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许可证
麻省理工学院