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

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

Clonar este repositorio:
git clone https://github.com/yourusername/edu-data-mcp-server.git cd edu-data-mcp-server
Instalar dependencias:
npm install
Construir el servidor:
npm run build
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 :

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

Para Claude en VSCode

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

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:

{
  "level": "schools",
  "source": "ccd",
  "topic": "enrollment",
  "subtopic": ["race", "sex"],
  "filters": {
    "year": 2008,
    "grade": [9, 10, 11, 12]
  },
  "add_labels": true,
  "limit": 50
}

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:

{
  "level": "schools",
  "source": "ccd",
  "topic": "enrollment",
  "stat": "sum",
  "var": "enrollment",
  "by": ["fips"],
  "filters": {
    "fips": [6, 7, 8],
    "year": [2004, 2005]
  }
}

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:

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

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

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
}

Desarrollo

Para ejecutar el servidor directamente:

npm start

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

npm run watch

Para inspeccionar las capacidades del servidor:

npm run inspector

Para ejecutar el servidor usando npx:

npx edu-data-mcp-server

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Education Data MCP Server

Integrations