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 許可證。