mcp-sql-api/ ├── app/ │ ├── main.py # Точка входа FastAPI │ ├── api/ # Уровень эндпоинтов │ │ ├── sql.py # Выполнение сырого SQL (шаг 1) │ │ ├── query.py # API выполнения запросов (шаг 3) │ │ └── agent.py # Интеграция с GPT (шаг 2) │ │ │ ├── core/ # Основная логика │ │ ├── db.py # Подключение к БД (PostgreSQL) │ │ └── security.py # Управление SQL (ограничения SELECT и т.д.) │ │ │ ├── services/ # Бизнес-логика │ │ ├── sql_executor.py # Движок выполнения SQL │ │ ├── query_service.py # Выполнение шаблонных запросов │ │ ├── llm_service.py # Генерация SQL с помощью GPT │ │ └── ir_service.py # Промежуточное представление → преобразование в SQL (шаг 4) │ │ │ ├── models/ # Модели данных │ │ ├── schema.py # Определение схемы БД │ │ ├── query.py # Определение запросов (с семантикой) │ │ └── ir.py # Промежуточное представление (критически важно) │ │ │ ├── repositories/ # Уровень доступа к БД │ │ └── base.py │ │ │ └── utils/ │ ├── logger.py │ └── validator.py │ ├── metadata/ # ← Ядро MCP │ ├── schema.yaml # Определение таблиц (для LLM) │ ├── metrics.yaml # Определение KPI │ └── queries.yaml # Определение семантических API │ ├── prompts/ # Промпты для GPT │ ├── sql_generation.txt │ └── ir_generation.txt │ ├── tests/ │ ├── test_sql.py │ ├── test_query.py │ └── test_ir.py │ ├── requirements.txt └── README.md