入学文件自动验证系统

git clone <repo-url> hansung-admission && cd hansung-admission
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env       # 그리고 .env 안에 ANTHROPIC_API_KEY 채워넣기
streamlit run demo/streamlit_app.py

[지원자 PDF 폴더]
       ↓
[AI 추출 — Claude Vision]   ← 자동 분류 + 정보 추출
       ↓
[규칙 검증 — 결정적 룰셋]    ← 모집요강 JSON 기준
       ↓
[종합 판정 + 4개 언어 안내 메일]

   ┌────────────────────────┐         ┌────────────────────────┐
   │ Streamlit 데모 화면     │         │ Claude Desktop / Code  │
   │ (입학처 직원용 UI)      │         │ (자연어 질의)          │
   └───────────┬────────────┘         └───────────┬────────────┘
               │                                  │ stdio (MCP)
               │ 직접 import                       │
               ↓                                  ↓
   ┌──────────────────────────────────────────────────────────┐
   │              admission/ (핵심 패키지)                     │
   │  ├─ extractors.py  · Claude Vision PDF → 구조화 데이터    │
   │  ├─ rules.py       · 결정적 검증 룰 (순수 함수)           │
   │  ├─ intake.py      · 추출+검증 파이프라인                 │
   │  └─ email.py       · 다국어 안내 메일 (한·영·중·베)       │
   └────────────────────────┬─────────────────────────────────┘
                            ↓
   ┌──────────────────────────────────────────────────────────┐
   │  data/*.json — 모집요강에서 추출한 룰셋 (출처 페이지 명시) │
   └──────────────────────────────────────────────────────────┘

mcp/
├── server.py                ← MCP 진입점, FastMCP 도구 17개
│
├── admission/               ← 핵심 패키지
│   ├── data.py              · data/*.json lru_cache 로더
│   ├── rules.py             · 결정 로직 (순수 함수)
│   ├── extractors.py        · PDF → 구조화 데이터 (Claude Vision, 8종)
│   ├── intake.py            · extract / validate / process 3단계
│   └── email.py             · 다국어 안내 메일 생성기
│
├── demo/                    ← Streamlit 데모
│   ├── streamlit_app.py     · 3단계 UI (정보 입력 → 검증 → 결과)
│   ├── mcp_adapter.py       · Claude API + MCP tool_use 어댑터
│   └── __init__.py
│
├── data/                    ← 모집요강 룰셋 (JSON 6종)
│   ├── departments.json     · 학과·TOPIK 요건
│   ├── scholarship.json     · 장학금 매트릭스
│   ├── documents.json       · 19종 서류 정의
│   ├── schedule.json        · 1·2차 일정·TOPIK 컷오프
│   ├── legalization.json    · 학력 인증 방식
│   └── contact.json         · 입학처 연락처
│
├── templates/               ← 다국어 메일 (4언어 × 2시나리오 = 8개)
├── samples/                 ← 합성 PDF + 가상 지원자 3명
├── tests/                   ← pytest 63개 케이스
├── scripts/                 ← 합성 PDF 생성기
├── docs/                    ← 모집요강 원본·공모전 자료
└── .streamlit/config.toml   ← 한성대 블루 테마

cd ~/Desktop/프로젝트파일/mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

cp .env.example .env
# .env 파일을 열어 ANTHROPIC_API_KEY 채워넣기

ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxxxxxx
ANTHROPIC_MODEL=claude-sonnet-4-6

source .venv/bin/activate
streamlit run demo/streamlit_app.py

{
  "mcpServers": {
    "hansung-admission": {
      "command": "/Users/raewon/Desktop/프로젝트파일/mcp/.venv/bin/python",
      "args": ["/Users/raewon/Desktop/프로젝트파일/mcp/server.py"]
    }
  }
}

{
  "mcpServers": {
    "hansung-admission": {
      "command": "./.venv/bin/python",
      "args": ["./server.py"]
    }
  }
}

from admission import intake

result = intake.process_application_folder(
    folder_path="samples/applicants/왕메이링_중국_글로벌K비즈니스",
    applicant_name="왕메이링",
    nationality="China",
    mother_nationality="China",
    father_nationality="China",
    department_key="global_k_business",
    track="korean",
)
print(result["overall"])      # 'pass' | 'review' | 'fail'
print(result["overall_flags"])

source .venv/bin/activate
pytest tests/ -v
# → 63 passed in 0.32s

python scripts/verify_topik_extraction.py
python scripts/verify_financial_extraction.py
# … 등

cd scripts
python generate_topik_samples.py            # TOPIK 4종
python generate_financial_samples.py        # 잔고증명 4종
python generate_korean_course_samples.py    # 한국어과정 수료증 4종
python generate_a_category_samples.py       # 응웬티흐엉 A카테고리 5종
python generate_demo_applicant.py           # 왕메이링 풀세트
python generate_demo_applicant_3.py         # 마리아 산토스 풀세트

Host ←→ MCP Client ←→ MCP Server

from fastmcp import FastMCP

mcp = FastMCP("My Server")

@mcp.tool()
def greet(name: str) -> str:
    """이름을 받아서 인사합니다"""
    return f"안녕하세요, {name}님!"

mcp.run()