src/
├── index.ts                          # 진입점
├── server/
│   └── McpServer.ts                  # MyunghwaMcpServer (StreamableHTTP MCP 서버)
├── database/
│   └── DatabaseManager.ts            # MSSQL 연결 풀 
├── logger/
│   └── Logger.ts                     # Pino 로거 
├── repositories/
│   ├── BaseRepository.ts            # 공통 쿼리 실행 (SQL Injection 방지)
│   ├── EquipTroubleRepository.ts    # 보전 일보 검색 · 상세 · 이력 · 주기 쿼리
│   ├── TroubleCountRepository.ts    # 고장 발생 빈도 집계 쿼리
│   ├── TroubleCauseRepository.ts    # 고장 원인 TOP N 쿼리
│   └── AnalysisRepository.ts        # MTBF · 수리비용 분석 쿼리
└── tools/
    ├── BaseTool.ts                   # McpTool 인터페이스 · 공통 스키마 · 헬퍼
    ├── ToolRegistry.ts               # 툴 인스턴스 등록 목록
    ├── EquipTroubleTool.ts           # 1. 사업장 목록 · 일보 검색
    ├── EquipTroubleDetailTool.ts     # 2. 설비 고장 상세 · 이력 · 주기
    ├── TroubleCountTool.ts           # 3. 고장 발생 빈도
    ├── TroubleCauseTool.ts           # 4. 고장 원인 TOP N
    └── AnalysisTools.ts              # 추가 기능 (MTBF · 수리비용)
scripts/
├── _helpers.ts                       # 공통 헬퍼
├── test-query-search.ts              # 보전 일보 검색 쿼리 테스트
├── test-query-detail.ts              # 설비 고장 상세 쿼리 테스트
├── test-query-count.ts               # 고장 빈도 쿼리 테스트
├── test-query-cause.ts               # 고장 원인 쿼리 테스트
└── test-query-analysis.ts            # MTBF · 수리비용 분석 쿼리 테스트

cp .env.example .env

npm install

npm run build

# 프로덕션
npm start

# 개발 모드 (코드 변경 시 자동 재시작)
npm run dev

# 기능별 스크립트를 직접 실행 (상단 TEST 파라미터를 실제 값으로 수정 후 실행)
npx tsx scripts/test-query-search.ts    # 보전 일보 검색
npx tsx scripts/test-query-detail.ts    # 설비 고장 상세/이력/주기
npx tsx scripts/test-query-count.ts     # 고장 발생 빈도
npx tsx scripts/test-query-cause.ts     # 고장 원인 TOP N
npx tsx scripts/test-query-analysis.ts  # MTBF · 수리비용 분석

Authorization: Bearer your-token-here