Servidor MCP de datos educativos

Este repositorio contiene un servidor MCP (Protocolo de Contexto de Modelo) que proporciona acceso a la API de Datos Educativos del Urban Institute. El servidor está diseñado para usarse con Claude y facilitar el acceso a los datos educativos.

Estructura del repositorio

• education-data-package-r/ : El paquete R original para acceder a la API de datos educativos (como referencia)

• src/ : El código fuente del servidor MCP

• build/ : El servidor MCP compilado

Related MCP server: MCP Alchemy

Acerca de la API de datos educativos

La API de datos educativos del Urban Institute proporciona acceso a una amplia gama de datos educativos, incluidos:

• Datos de matriculación de escuelas y distritos

• Datos de colegios y universidades

• Datos de evaluación

• Datos financieros

• Y mucho más

La API está organizada por niveles (escuelas, distritos escolares, colegio-universidad), fuentes (ccd, ipeds, crdc, etc.) y temas (inscripción, directorio, finanzas, etc.).

Características

• Recupere datos educativos detallados a través de la herramienta get_education_data

• Recupere datos educativos agregados mediante la herramienta get_education_data_summary

• Explorar los puntos finales disponibles a través de los recursos

Instalación

1. Clonar este repositorio:

   git clone https://github.com/yourusername/edu-data-mcp-server.git cd edu-data-mcp-server

2. Instalar dependencias:

   npm install

3. Construir el servidor:

   npm run build

4. Hacer que el servidor esté disponible para npx:

   npm link

Configuración del servidor MCP

Para utilizar este servidor MCP con Claude, debe agregarlo a su archivo de configuración de MCP.

Para la aplicación de escritorio de Claude (macOS)

Editar ~/Library/Application Support/Claude/claude_desktop_config.json :

Para Claude en VSCode

Editar /home/codespace/.vscode-remote/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json :

Herramientas disponibles

obtener datos educativos

Recupera datos educativos detallados de la API.

Parámetros:

• level (obligatorio): nivel de datos de la API para consultar (por ejemplo, 'escuelas', 'distritos escolares', 'universidad')

• source (obligatoria): fuente de datos API para consultar (por ejemplo, 'ccd', 'ipeds', 'crdc')

• topic (obligatorio): tema de datos de la API para consultar (por ejemplo, 'inscripción', 'directorio')

• subtopic (opcional): Lista de parámetros de agrupación (por ejemplo, ['raza', 'sexo'])

• filters (opcionales): filtros de consulta (por ejemplo, {año: 2008, grado: [9,10,11,12]})

• add_labels (opcional): agrega etiquetas de variables cuando corresponda (predeterminado: falso)

• limit (opcional): Limita el número de resultados (predeterminado: 100)

Ejemplo:

obtener_resumen_de_datos_educativos

Recupera datos educativos agregados de la API.

Parámetros:

• level (obligatorio): Nivel de datos de la API a consultar

• source (obligatoria): fuente de datos API para consultar

• topic (obligatorio): tema de datos de la API para consultar

• subtopic (opcional): Parámetros adicionales (solo aplicables a ciertos puntos finales)

• stat (obligatorio): Estadística de resumen a calcular (por ejemplo, 'suma', 'promedio', 'conteo', 'mediana')

• var (obligatorio): Variable a resumir

• by (obligatorio): Variables para agrupar los resultados

• filters (opcional): filtros de consulta

Ejemplo:

Recursos disponibles

El servidor proporciona recursos para explorar los puntos finales disponibles:

• edu-data://endpoints/{level}/{source}/{topic} : Información sobre un punto final de datos educativos específico

Ejemplo de uso con Claude

Una vez configurado el servidor MCP, puedes usarlo con Claude para acceder a los datos educativos:

Luego, Claude puede usar el servidor MCP para recuperar y analizar los datos:

Desarrollo

Para ejecutar el servidor directamente:

Para ejecutar el servidor en modo de observación durante el desarrollo:

Para inspeccionar las capacidades del servidor:

Para ejecutar el servidor usando npx:

Licencia

Instituto Tecnológico de Massachusetts (MIT)