eph-context

Que la IA escriba tu código de EPH sin inventar lo que no existe

Los modelos de IA alucinan variables de la EPH que no existen, aplican mal los ponderadores y se olvidan del panel rotante. eph-context le da al modelo los diseños de registro oficiales del INDEC y las reglas metodológicas antes de que escriba una línea. Resultado: código correcto, sin inventos.

¿Qué herramienta usás?

Related MCP server: bora-mcp

ChatGPT — sin instalar nada

La opción más simple. Funciona directamente en chatgpt.com creando un GPT personalizado con el conocimiento de la EPH incluido.

Qué vas a necesitar

• Una cuenta de ChatGPT Plus (pago) — necesaria para subir archivos de conocimiento a un GPT personalizado

• Los archivos de la carpeta assets/ de este repositorio

Pasos

1. Descargá los archivos de conocimiento

Andá a la página principal del repositorio en GitHub, hacé clic en el botón verde Code → Download ZIP y descomprimí el archivo en tu computadora.

2. Creá un GPT personalizado

En chatgpt.com:

• Hacé clic en tu nombre (abajo a la izquierda) → My GPTs → Create a GPT

• En la pestaña Configure, completá:

  • Name: Asistente EPH INDEC

  • Instructions: copiá y pegá todo el contenido del archivo gpt_instructions.md que está en este repositorio

3. Subí los archivos de conocimiento

En la misma pantalla de configuración, en la sección Knowledge, hacé clic en Upload files y subí todos los archivos .md de la carpeta assets/ (design, methodology, classifiers, tools).

4. Guardá y empezá a usarlo

Hacé clic en Save (arriba a la derecha) y listo. Podés empezar a preguntarle sobre la EPH o pedirle que te escriba código.

Nota: Para subir archivos de conocimiento necesitás ChatGPT Plus (pago). Con la versión gratuita podés pegar el contenido de los archivos directamente en el chat cuando lo necesites.

Claude Desktop

Claude Desktop es la aplicación de escritorio de Anthropic. Si no la tenés, descargala desde claude.ai/download.

Lo que vas a necesitar instalar primero: uv

uv es una herramienta que maneja las dependencias de Python. Sin ella no va a funcionar.

En Mac o Linux, abrí la Terminal y pegá:

curl -LsSf https://astral.sh/uv/install.sh | sh

En Windows, abrí PowerShell y pegá:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Cerrá y volvé a abrir la terminal después de instalar.

Pasos

1. Descargá este repositorio

Si tenés git instalado, en la terminal:

git clone https://github.com/matias-denatale/eph-context.git

Si no tenés git, descargá el ZIP desde GitHub (botón verde Code → Download ZIP) y descomprimilo donde quieras. Guardá la ruta de la carpeta — la vas a necesitar.

2. Abrí el archivo de configuración de Claude Desktop

Andá a Claude Desktop → menú Claude (arriba) → Settings → Developer → Edit Config.

Se va a abrir un archivo claude_desktop_config.json. Si está vacío, pegá esto directamente:

{
  "mcpServers": {
    "eph": {
      "command": "uv",
      "args": [
        "--directory",
        "/ruta/a/eph-context",
        "run",
        "server.py"
      ]
    }
  }
}

Si ya tiene contenido, agregá solo la parte de "eph": { ... } dentro de "mcpServers".

3. Reemplazá la ruta

Cambiá /ruta/a/eph-context por la ruta real donde descomprimiste el repositorio.

• Mac/Linux: algo como /Users/tu-nombre/eph-context

• Windows: algo como C:\\Users\\tu-nombre\\eph-context (con doble barra invertida)

4. Guardá y reiniciá Claude Desktop

Cerrá y volvé a abrir Claude Desktop. Las herramientas EPH van a aparecer disponibles — las podés ver haciendo clic en el ícono de herramientas (🔧) en el chat.

Cursor

Cursor es un IDE basado en VS Code con IA integrada. Si no lo tenés, descargalo desde cursor.com.

Necesitás tener uv instalado (ver instrucciones en la sección de Claude Desktop).

Pasos

1. Descargá este repositorio (igual que en Claude Desktop, paso 1)

2. Abrí la configuración de MCP en Cursor

Cursor → Settings → Cursor Settings → MCP → Add new MCP server

O bien editá el archivo ~/.cursor/mcp.json directamente y agregá:

{
  "mcpServers": {
    "eph": {
      "command": "uv",
      "args": [
        "--directory",
        "/ruta/a/eph-context",
        "run",
        "server.py"
      ]
    }
  }
}

3. Reemplazá la ruta y reiniciá Cursor

VS Code

Necesitás la extensión GitHub Copilot o Continue con soporte MCP.

Necesitás tener uv instalado (ver instrucciones en la sección de Claude Desktop).

Pasos

1. Descargá este repositorio (igual que en Claude Desktop, paso 1)

2. Editá el archivo de configuración MCP

Creá o editá .vscode/mcp.json en tu proyecto:

{
  "servers": {
    "eph": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/ruta/a/eph-context",
        "run",
        "server.py"
      ]
    }
  }
}

3. Reemplazá la ruta y reiniciá VS Code

Claude Code CLI

Para usuarios del CLI de Claude Code en terminal.

1. Cloná el repositorio en tu carpeta de skills:

git clone https://github.com/matias-denatale/eph-context.git ~/.claude/skills/eph

2. Agregá esta línea a tu ~/.claude/CLAUDE.md en la tabla de skills:

| EPH microdata, usu_hogar, usu_individual, scripts R/Python con EPH | `~/.claude/skills/eph/SKILL.md` |

La skill se activa automáticamente cuando Claude Code detecta consultas sobre EPH, variables como CODUSU, PONDERA, ESTADO, etc.

¿Qué sabe hacer?

Una vez instalado, podés pedirle cosas como:

• "Calculá la tasa de desocupación para el 2do trimestre de 2024 con R"

• "¿Qué es el panel rotante y cómo afecta el análisis longitudinal?"

• "Escribime un script en Python para calcular informalidad laboral"

• "¿Cómo mergeo las bases de hogar e individual?"

• "¿Qué variables cambaron en el 4T2023?"

El modelo siempre consulta los diseños de registro y la metodología oficial antes de responder. No adivina, no improvisa.

Ejemplo de sesión

Usuario: Calculá la tasa de desocupación para el 4T2024 con R.

El modelo (internamente):

1. eph_setup() → recibe workflow obligatorio + reglas críticas

2. get_design_record("31_aglomerados_post") → variables ESTADO, PONDERA y sus categorías exactas

3. get_methodology("indicadores_mercado_laboral") → fórmula oficial INDEC

Respuesta del modelo:

library(eph)

base <- get_microdata(year = 2024, trimester = 4, type = "individual")

base |>
  summarise(
    desocupacion = sum(PONDERA[ESTADO == 2]) / sum(PONDERA[ESTADO %in% c(1, 2)]) * 100
  )

Sin inventar nombres de variables. Sin ponderadores incorrectos. Sin mezclar períodos pre/post 4T2023.

¿Qué incluye?

Agradecimientos

• Diego Kozlowski — creador del paquete eph para R

• Guido Weksler — Introducción a R para Ciencias Sociales

• Pablo Tiscornia — Curso R INDEC

Autor

Desarrollado por Matías De Natale.

Licencia

MIT. Usalo, modificálo, compartilo. Si lo mejorás, mandá un PR.