mcp-sql-api/ ├── app/ │ ├── main.py # Punto de entrada de FastAPI │ ├── api/ # Capa de endpoints │ │ ├── sql.py # Ejecución de SQL sin procesar (paso 1) │ │ ├── query.py # API de ejecución de consultas (paso 3) │ │ └── agent.py # Integración con GPT (paso 2) │ │ │ ├── core/ # Lógica central │ │ ├── db.py # Conexión a BD (PostgreSQL) │ │ └── security.py # Control de SQL (restricciones de SELECT, etc.) │ │ │ ├── services/ # Lógica de negocio │ │ ├── sql_executor.py # Motor de ejecución de SQL │ │ ├── query_service.py # Ejecución de consultas de plantilla │ │ ├── llm_service.py # Generación de SQL con GPT │ │ └── ir_service.py # Conversión de representación intermedia → SQL (paso 4) │ │ │ ├── models/ # Modelos de datos │ │ ├── schema.py # Definición de esquema de BD │ │ ├── query.py # Definición de consultas (con semántica) │ │ └── ir.py # Representación intermedia (muy importante) │ │ │ ├── repositories/ # Capa de acceso a BD │ │ └── base.py │ │ │ └── utils/ │ ├── logger.py │ └── validator.py │ ├── metadata/ # ← Núcleo de MCP │ ├── schema.yaml # Definición de tablas (para LLM) │ ├── metrics.yaml # Definición de KPI │ └── queries.yaml # Definición de API con significado │ ├── prompts/ # Prompts para GPT │ ├── sql_generation.txt │ └── ir_generation.txt │ ├── tests/ │ ├── test_sql.py │ ├── test_query.py │ └── test_ir.py │ ├── requirements.txt └── README.md