教育データMCPサーバー

このリポジトリには、Urban Instituteの教育データAPIへのアクセスを提供するMCP（Model Context Protocol）サーバーが含まれています。このサーバーは、Claudeと組み合わせて使用することで、教育データへの容易なアクセスを可能にするように設計されています。

リポジトリ構造

• education-data-package-r/ : Education Data API にアクセスするためのオリジナルの R パッケージ (参考用)

• src/ : MCPサーバーのソースコード

• build/ : コンパイルされたMCPサーバー

Related MCP server: Slate MCP Server

教育データAPIについて

Urban Institute の教育データ API は、次のような幅広い教育データへのアクセスを提供します。

• 学校および学区の入学データ

• 大学のデータ

• 評価データ

• 財務データ

• その他にも

API は、レベル (学校、学区、大学)、ソース (ccd、ipeds、crdc など)、トピック (登録、ディレクトリ、財務など) 別に整理されています。

特徴

• 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 デスクトップ アプリ (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": []
    }
  }
}

利用可能なツール

教育データを取得する

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

パラメータ:

• level （必須）: クエリする API データ レベル（例: 'schools'、'school-districts'、'college-university'）

• source （必須）: クエリする API データ ソース（例: 'ccd'、'ipeds'、'crdc'）

• topic (必須): クエリする API データ トピック (例: 'enrollment'、'directory')

• subtopic （オプション）：グループ化パラメータのリスト（例：['人種', '性別']）

• 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
}

教育データの概要を取得する

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} : 特定の教育データエンドポイントに関する情報

クロードとの使用例

MCP サーバーが設定されると、Claude で使用して教育データにアクセスできます。

Can you show me the enrollment data for high schools in California for 2020?

その後、クロードは 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

ライセンス

マサチューセッツ工科大学