Education Data MCP Server

Education Data MCP Server

このリポジトリには、Urban Institute の Education Data API へのアクセスを提供する MCP（Model Context Protocol）サーバーが含まれています。このサーバーは Claude と連携し、教育データに簡単にアクセスできるように設計されています。

リポジトリの構成

• education-data-package-r/：Education Data API にアクセスするための元の R パッケージ（参考用）
• src/：MCP サーバーのソースコード
• build/：コンパイル済みの MCP サーバー

Education Data API について

Urban Institute の Education Data API では、次のような幅広い教育データにアクセスできます。

• 学校および学区の在籍者データ
• 大学およびカレッジのデータ
• 評価データ
• 財務データ
• その他多数

API はレベル（schools、school-districts、college-university）、ソース（ccd、ipeds、crdc など）、トピック（enrollment、directory、finance など）ごとに整理されています。

機能

• 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
   

3. サーバーをビルドします。

   npm run build
   

4. サーバーを npx から利用できるようにします。

   npm link
   

MCP サーバーの設定

この MCP サーバーを Claude で使用するには、MCP 設定ファイルに追加する必要があります。

Claude Desktop App（macOS）の場合

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "edu-data": {
      "command": "npx",
      "args": ["edu-data-mcp-server"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

VSCode の Claude の場合

/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": []
    }
  }
}

利用可能なツール

get_education_data

API から詳細な教育データを取得します。

パラメーター：

• level（必須）：照会する API データのレベル（例：'schools'、'school-districts'、'college-university'）
• source（必須）：照会する API データのソース（例：'ccd'、'ipeds'、'crdc'）
• topic（必須）：照会する API データのトピック（例：'enrollment'、'directory'）
• subtopic（任意）：グループ化パラメーターのリスト（例：['race'、'sex']）
• filters（任意）：クエリフィルター（例：{year: 2008, grade: [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（必須）：計算する要約統計量（例：'sum'、'avg'、'count'、'median'）
• 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

ライセンス

MIT