# 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:

```bash
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:

```json
{
  "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

```bash
# 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)

```bash
npm run start:sse
```

Configuración en AI Toolkit:
```json
{
  "mcpServers": {
    "ine-sse": {
      "url": "http://localhost:3001/sse",
      "transport": "sse"
    }
  }
}
```

### Modo stdio

```bash
node dist/index.js --stdio
```

Configuración en AI Toolkit:
```json
{
  "mcpServers": {
    "ine-stdio": {
      "command": "node",
      "args": ["dist/index.js", "--stdio"],
      "cwd": "/ruta/completa/a/mcp-ine"
    }
  }
}
```

## Recursos Adicionales

- [Documentación API INE](https://www.ine.es/dyngs/DataLab/manual.html?cid=45)
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [AI Toolkit Documentation](https://github.com/microsoft/vscode-ai-toolkit)

---

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