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: Slate MCP Server

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 :

{
  "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)