mcp-ine/QUICKSTART.md

Guía Rápida de Configuración para VS Code AI Toolkit

Configuración del Servidor MCP INE

Paso 1: Iniciar el Servidor

Abre una terminal en la carpeta mcp-ine y ejecuta:

npm start

El servidor iniciará en http://localhost:3000

Paso 2: Configurar AI Toolkit

1. Abre VS Code
2. Instala la extensión AI Toolkit (si no la tienes)
3. Presiona Ctrl+Shift+P (o Cmd+Shift+P en Mac)
4. Busca: "AI Toolkit: Configure MCP Servers"
5. Agrega la siguiente configuración:

{
  "mcpServers": {
    "ine-spain": {
      "url": "http://localhost:3000/mcp/v1",
      "transport": "http",
      "description": "API Estadísticas INE España"
    }
  }
}

Paso 3: Verificar Conexión

En AI Toolkit, deberías ver el servidor "ine-spain" activo con las 24 herramientas disponibles.

Ejemplos de Consultas en el Chat

Una vez configurado, puedes hacer preguntas directamente:

Consultas sobre el IPC

¿Cuál es el último valor del IPC en España?

Dame los últimos 12 meses del IPC con formato amigable

¿Cuál ha sido la variación mensual del IPC en los últimos 6 meses?

Consultas sobre Operaciones

¿Qué operaciones estadísticas tiene disponibles el INE?

Lista las operaciones relacionadas con población

Dame información sobre la operación IPC

Consultas sobre Datos Específicos

Obtén los datos de la tabla 50902 de los últimos 3 períodos

¿Qué variables tiene la operación EPA (Encuesta de Población Activa)?

Dame las series de la operación IPC con periodicidad mensual

Consultas con Filtros

Busca datos del IPC para Madrid con variación mensual

Dame los grupos ECOICOP del IPC

¿Qué provincias tiene disponibles la variable 115?

Herramientas MCP Disponibles

🔢 Datos

• ine_datos_tabla: Datos de tablas
• ine_datos_serie: Datos de series temporales
• ine_datos_metadata_operacion: Datos con filtros avanzados

📊 Operaciones

• ine_operaciones_disponibles: Lista de operaciones
• ine_operacion: Info de operación específica

📈 Series

• ine_serie: Info de serie
• ine_series_operacion: Series de una operación
• ine_series_tabla: Series de una tabla
• ine_valores_serie: Variables de una serie
• ine_serie_metadata_operacion: Búsqueda avanzada

📋 Tablas

• ine_tablas_operacion: Tablas de una operación
• ine_grupos_tabla: Grupos de una tabla
• ine_valores_grupos_tabla: Valores de grupos

🏷️ Variables

• ine_variables: Lista de variables
• ine_variables_operacion: Variables de operación
• ine_valores_variable: Valores de variable
• ine_valores_variable_operacion: Valores en operación
• ine_valores_hijos: Valores jerárquicos

📚 Metadatos

• ine_periodicidades: Periodicidades disponibles
• ine_publicaciones: Lista de publicaciones
• ine_publicaciones_operacion: Publicaciones de operación
• ine_publicacion_fecha_publicacion: Fechas de publicación
• ine_clasificaciones: Clasificaciones
• ine_clasificaciones_operacion: Clasificaciones de operación

Códigos de Operaciones Comunes

• IPC: Índice de Precios de Consumo
• EPA: Encuesta de Población Activa
• CNE: Contabilidad Nacional
• 30138: IPC (código IOE)
• 30308: EPA (código IOE)

Códigos de Tablas Comunes

• 50902: IPC - Índices nacionales: general y de grupos ECOICOP
• 50913: IPC - Índices por comunidades autónomas

Parámetros Útiles

Idioma

• ES: Español (predeterminado)
• EN: Inglés

Nivel de Detalle (det)

• 0: Básico
• 1: Medio
• 2: Completo (recomendado para análisis detallado)

Tipo de Respuesta (tip)

• A: Formato amigable/legible
• M: Con metadatos
• AM: Amigable con metadatos (recomendado)

Periodicidad (p)

• 1: Mensual
• 3: Trimestral
• 6: Semestral
• 12: Anual

Verificar Estado del Servidor

# Health check
curl http://localhost:3000/health

# Listar herramientas MCP
curl -X POST http://localhost:3000/mcp/v1 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":1}'

Documentación Swagger

Para explorar la API REST y probar endpoints:

🌐 http://localhost:3000/api-docs

Troubleshooting

No aparece el servidor en AI Toolkit

1. Verifica que el servidor esté corriendo: http://localhost:3000/health
2. Reinicia VS Code
3. Verifica la configuración MCP en AI Toolkit

Errores de conexión

• Asegúrate de que no hay otro proceso en el puerto 3000
• Usa netstat -tuln | grep 3000 para verificar

El servidor no responde

• Verifica los logs de la terminal donde corre el servidor
• Reinicia el servidor con npm start

Modos Alternativos

Modo SSE (Server-Sent Events)

npm run start:sse

Configuración en AI Toolkit:

{
  "mcpServers": {
    "ine-sse": {
      "url": "http://localhost:3001/sse",
      "transport": "sse"
    }
  }
}

Modo stdio

node dist/index.js --stdio

Configuración en AI Toolkit:

{
  "mcpServers": {
    "ine-stdio": {
      "command": "node",
      "args": ["dist/index.js", "--stdio"],
      "cwd": "/ruta/completa/a/mcp-ine"
    }
  }
}

Recursos Adicionales

• Documentación API INE
• Model Context Protocol
• AI Toolkit Documentation

---

💡 Tip: Comienza preguntando por las operaciones disponibles para familiarizarte con los datos del INE.