Skip to main content
Glama
README.md
# ine-chile-mcp

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Servidor MCP open-source que expone las APIs públicas del **Instituto Nacional de Estadísticas de Chile (INE)** como herramientas para LLMs.

## Herramientas disponibles

| Herramienta | Descripción |
|---|---|
| `datos_search_datasets` | Busca datasets del INE en datos.gob.cl |
| `datos_get_dataset` | Metadata completa de un dataset |
| `datos_query_resource` | Consulta filas de un recurso tabular CKAN |
| `inestat_list_dataflows` | Lista dataflows disponibles en INE.Stat |
| `inestat_get_structure` | Estructura de dimensiones de un dataflow |
| `inestat_get_data` | Consulta observaciones SDMX-JSON |
| `simel_list_dataflows` | Lista indicadores laborales (ENE, ESI) |
| `simel_get_data` | Consulta series de mercado laboral |
| `codif_classify_activity` | Clasifica actividades en CAENES |
| `codif_classify_occupation` | Clasifica ocupaciones en CIUO-08.CL |
| `codif_get_training_data` | Datos de entrenamiento del clasificador |

## Instalación rápida (Claude Desktop)

```json
{
  "mcpServers": {
    "ine-chile": {
      "command": "node",
      "args": ["/ruta/a/ine-chile-mcp/dist/index.js"]
    }
  }
}
```

## Desarrollo

```bash
pnpm install
pnpm build
pnpm test
pnpm dev          # watch mode (stdio)
pnpm start:http   # servidor HTTP en puerto 3000
```

## Docker

```bash
docker build -t ine-chile-mcp .
docker run -p 3000:3000 ine-chile-mcp
```

El endpoint MCP estará en `http://localhost:3000/mcp`.

## APIs upstream

- **INE.Stat** (stat.ine.cl) — SDMX-JSON, indicadores económicos y ambientales
- **SIMEL** — Mercado laboral (ENE, ESI) via INE.Stat
- **Codificación** (rapps.ine.cl:9292) — Clasificación automática CAENES/CIUO-08
- **Datos Abiertos** (datos.gob.cl) — Portal CKAN con datasets del INE

## Licencia

MIT

TDQS

A3.9/5.0

Scored across 11 tools

Disambiguation5/5

Each tool has a distinct purpose with clear boundaries: codif_* tools handle classification and training data, datos_* tools manage dataset metadata and queries, inestat_* tools access statistical dataflows and structures, and simel_* tools focus on labor market indicators. There is no overlap in functionality, making tool selection unambiguous.

Naming Consistency5/5

Tool names follow a consistent verb_noun pattern with a clear prefix system: codif_, datos_, inestat_, and simel_ indicate the domain, followed by descriptive actions like classify, get, query, search, and list. This structured naming makes the tool set predictable and easy to navigate.

Tool Count5/5

With 11 tools, the server is well-scoped for its purpose of accessing INE Chile data across classification, datasets, statistics, and labor market indicators. Each tool serves a specific function, and the count is neither too sparse nor overwhelming for the domain coverage.

Completeness5/5

The tool set provides comprehensive coverage for interacting with INE Chile's data systems: classification (CAENES/CIUO), dataset metadata and queries (CKAN), statistical dataflows (INE.Stat), and labor market indicators (SIMEL). It supports full workflows from discovery to data retrieval, with no obvious gaps in the surface.