교육 데이터 MCP 서버

이 저장소에는 Urban Institute의 교육 데이터 API에 대한 액세스를 제공하는 MCP(Model Context Protocol) 서버가 포함되어 있습니다. 이 서버는 Claude와 함께 사용하여 교육 데이터에 쉽게 액세스할 수 있도록 설계되었습니다.

저장소 구조

• education-data-package-r/ : 교육 데이터 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. 이 저장소를 복제하세요:

   지엑스피1

2. 종속성 설치:

   npm install

3. 서버를 빌드하세요:

   npm run build

4. npx에서 서버를 사용할 수 있도록 설정하세요.

   npm link

MCP 서버 구성

Claude와 함께 이 MCP 서버를 사용하려면 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 데이터 레벨(예: '학교', '학군', '대학')

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

교육 데이터 요약 받기

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