# MCP INEGI Mujeres

Servidor MCP (Model Context Protocol) que expone indicadores educativos con perspectiva de género extraídos del **Sistema Integrado de Estadísticas sobre Violencia Contra las Mujeres (SIESVIM)** del INEGI.

Permite que un modelo de lenguaje como Claude consulte datos oficiales desagregados por sexo —eficiencia terminal, abandono escolar, alfabetización, cobertura, entre otros— para producir análisis contextualizados y citables.

---

## Objetivo

Demostrar el uso de MCP como infraestructura para investigación social basada en datos abiertos, conectando un LLM con estadísticas oficiales del INEGI, la SEP y el CONAPO, desagregadas por género.

---

## Estructura del proyecto

```
MCPInegiMujeres/
├── src/
│   ├── index.ts              # Servidor MCP principal
│   └── resources/            # Datos en formato CSV
│       ├── eficiencia-terminal-nivel-educativo.csv
│       ├── tasa-absorcion-nivel-educativo.csv
│       ├── tasa-abandono-nivel-educativo.csv
│       ├── tasa-reprobacion-nivel-educativo.csv
│       ├── tasa-cobertura-nivel-educativo.csv
│       ├── años-promedio-escolaridad-15-mas.csv
│       ├── porcentaje-poblacion-nivel-escolaridad.csv
│       ├── porcentaje-poblacion-condicion-leer-escribir.csv
│       └── porcentaje-poblacion-asistencia-escolar.csv
├── build/                    # Salida compilada (generada por tsc)
├── tsconfig.json
└── package.json
```

---

## Requisitos

- **Node.js** >= 18
- **pnpm** (o npm / yarn)

---

## Puesta en marcha

### 1. Instalar dependencias

```bash
pnpm install
```

### 2. Compilar el proyecto

```bash
pnpm build
```

Esto genera la carpeta `build/` con el JavaScript listo para ejecutarse.

### 3. Levantar el servidor

```bash
node build/index.js
```

El servidor queda disponible en:

```
http://localhost:3000/mcp
```

---

## Conexion con Claude Code CLI

Para agregar este servidor MCP a Claude Code, edita el archivo de configuracion de MCP:

```bash
claude mcp add --transport http McpInegiMujeres http://localhost:3000/mcp
```

Verificar que el servidor fue registrado correctamente:

```bash
claude mcp list
```

Una vez conectado, Claude Code tendra acceso a los recursos, herramientas y prompts del servidor durante la sesion.

### Uso desde Claude Code

Con el servidor activo y registrado, puedes invocar sus capacidades directamente en el chat:

**Consultar la fuente de los datos:**

```
usa el tool fuente-indicadores-educacion
```

**Analizar un indicador:**

```
de acuerdo a INEGI Mujeres, analiza la eficiencia terminal por nivel educativo de la mujer
```

**Ejecutar un prompt predefinido:**

```
ejecuta el prompt eficiencia-terminal-trayectoria-educativa-mujeres
```

---

## Capacidades del servidor

### Resources (9 datasets)

| Recurso | Fuente | Periodo |
|---|---|---|
| `eficiencia-terminal-nivel-educativo` | SEP / Formato 911 | 2012–2024 |
| `tasa-absorcion-nivel-educativo` | SEP / Formato 911 | 2012–2025 |
| `tasa-abandono-nivel-educativo` | SEP / Formato 911 | 2012–2024 |
| `tasa-reprobacion-nivel-educativo` | SEP / Formato 911 | 2012–2024 |
| `tasa-cobertura-nivel-educativo` | CONAPO | Proyecciones 2020–2070 |
| `años-promedio-escolaridad-15-mas` | INEGI / Censos | 1990–2020 |
| `porcentaje-poblacion-nivel-escolaridad` | INEGI / Censos | 1990–2020 |
| `porcentaje-poblacion-condicion-leer-escribir` | INEGI / Censos | 1990–2020 |
| `porcentaje-poblacion-asistencia-escolar` | INEGI / Censos | 1990–2020 |

### Tools

| Tool | Descripcion |
|---|---|
| `fuente-indicadores-educacion` | Retorna nombre, URL, indicadores y descripcion del SIESVIM |

### Prompts

| Prompt | Descripcion |
|---|---|
| `brecha-genero-absorcion-educativa` | Brecha de genero en absorcion escolar por nivel |
| `impacto-pandemia-educacion-mujeres` | Efecto de COVID-19 en indicadores educativos femeninos |
| `evolucion-historica-escolaridad-femenina` | Escolaridad femenina de 1990 a 2020 |
| `alfabetizacion-brecha-genero` | Evolucion de la alfabetizacion femenina |
| `abandono-escolar-femenino-causas-tendencias` | Tendencias de abandono y reprobacion femenina |
| `cobertura-educativa-proyecciones-equidad` | Cobertura educativa y proyecciones de equidad de genero |
| `eficiencia-terminal-trayectoria-educativa-mujeres` | Trayectoria escolar completa de las mujeres |

---

## Fuente de datos

**Sistema Integrado de Estadísticas sobre Violencia Contra las Mujeres (SIESVIM)**
INEGI — [https://sc.inegi.org.mx/SIESVIM1/](https://sc.inegi.org.mx/SIESVIM1/)

Ultima actualizacion de indicadores: **23 de enero de 2026**

---

## Autor

[@rulopimentel](https://github.com/rulopimentel)