mcp-sql-api/ ├── app/ │ ├── main.py # FastAPI 진입점 │ ├── api/ # 엔드포인트 계층 │ │ ├── sql.py # 원시 SQL 실행 (step1) │ │ ├── query.py # 쿼리 실행 API (step3) │ │ └── agent.py # GPT 연동 (step2) │ │ │ ├── core/ # 핵심 로직 │ │ ├── db.py # DB 연결 (PostgreSQL) │ │ └── security.py # SQL 제어 (SELECT 제한 등) │ │ │ ├── services/ # 비즈니스 로직 │ │ ├── sql_executor.py # SQL 실행 엔진 │ │ ├── query_service.py # 템플릿 쿼리 실행 │ │ ├── llm_service.py # GPT를 통한 SQL 생성 │ │ └── ir_service.py # 중간 표현 → SQL 변환 (step4) │ │ │ ├── models/ # 데이터 모델 │ │ ├── schema.py # DB 스키마 정의 │ │ ├── query.py # 쿼리 정의 (의미 포함) │ │ └── ir.py # 중간 표현 (매우 중요) │ │ │ ├── repositories/ # DB 접근 계층 │ │ └── 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