npm install

SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_supabase_anon_key

-- mastery_score, last_reviewed_at, review_count 컬럼 추가
-- 인덱스 생성

node seed.js

npm run build

{
  "mcpServers": {
    "toeic-speaking": {
      "command": "node",
      "args": ["/절대/경로/dist/main.js"],
      "env": {
        "SUPABASE_URL": "your_url",
        "SUPABASE_ANON_KEY": "your_key"
      }
    }
  }
}

{
  "id": "uuid",
  "sentence_ko": "이 사진은 공원에서 찍힌 사진입니다.",
  "part": 2,
  "current_mastery": 0
}

{
  "success": true,
  "original_sentence": "This is a picture taken at a park.",
  "matched_keywords": ["picture", "taken", "park"],
  "missing_keywords": [],
  "match_rate": "100.0%",
  "score_change": 10,
  "feedback": "Perfect! All keywords matched. Score increased by 10 points."
}

👤 "토익 스피킹 연습 시작할게요"

🤖 [get_quiz_sentence 호출]
   문제: "이 사진은 공원에서 찍힌 사진입니다."
   (현재 숙련도: 0점)

👤 [음성] "This is a picture taken at a park"

🤖 [verify_answer 호출]
   ✅ 완벽합니다!
   - 포함된 키워드: picture, taken, park (3/3)
   - 매칭률: 100.0%
   - 점수 변화: +10점

src/
├── main.ts                    # MCP 서버 엔트리포인트
├── app.module.ts              # 루트 모듈
├── config/
│   └── supabase.config.ts     # Supabase DI Provider
├── types/
│   └── sentence.interface.ts  # TypeScript 인터페이스
├── mcp/
│   ├── mcp.module.ts
│   └── mcp.service.ts         # MCP 도구 정의 + Zod 검증
├── quiz/                      # Quiz 도메인
│   ├── quiz.module.ts
│   ├── quiz.service.ts        # 문제 출제 로직
│   └── quiz.repository.ts     # DB 쿼리
└── answer/                    # Answer 도메인
    ├── answer.module.ts
    ├── answer.service.ts      # 키워드 매칭 알고리즘
    └── answer.repository.ts   # 점수 업데이트

Claude Desktop (stdio)
    ↓
MCP Layer (Zod 검증)
    ↓
Domain Layer (Quiz/Answer)
    ↓
Supabase PostgreSQL

rm -rf node_modules package-lock.json
npm install
npm run build

# 빌드
npm run build

# 개발 모드
npm run start:dev

# 실행
npm start

# 샘플 데이터
node seed.js

# 타입 체크
npx tsc --noEmit