20260403 TIL

•  

📅 2026년 04월 03일 TIL

📚 과목: LLM 텍스트분석 | 참여자: 무아튜터님

📌 주제: MCP 심화 실습 & 구조화된 출력(Structured Output)

---

✅ 오늘 배운 것

• MCP 파일 시스템 실습 — MCPServerStdio로 파일 읽기·생성·검색 도구를 Agent에 등록하고 활용. 보안상 접근 허용 디렉터리를 반드시 지정해야 함.
• Fetch MCP & 복합 MCP — uvx로 웹페이지 텍스트 추출 MCP 실행, 파일 시스템 MCP와 조합하여 "웹에서 가져오기 → 파일 저장" 자동화 구현.
• Notion MCP — 외부 서버형 MCP로 API 키(토큰) 발급 후 연결. 로컬 서버형(파일 MCP)과 외부 서버형(Notion MCP)의 차이 학습.
• 하네스 엔지니어링(Harness Engineering) — 프롬프트 엔지니어링을 넘어, LLM이 잘 일할 수 있는 환경(모델 선정 + MCP 도구 + 메모리 + 컨텍스트)을 구축하는 새 패러다임. 도구 과다 등록 시 토큰 낭비·판단력 저하 발생 → 업무에 딱 맞는 MCP만 선별 등록이 핵심.
• 구조화된 출력(Structured Output) — Pydantic BaseModel로 응답 스키마를 설계하고 output_type에 등록하면 AI가 해당 구조로 응답. 비정형 데이터를 정형화하는 핵심 기술.
• Field 제약 조건 — Literal(범주 강제), Optional(None 허용), min_length/max_length, ge/le 등으로 응답 형식 강제.
• 검증 & 재시도 — retries 파라미터로 자동 재시도, @agent.output_validator로 다중 필드 간 논리적 관계 커스텀 검증.
• 실습 — 영화 리뷰 구조화 분석 + 고객 문의 자동 분류(유형·긴급도·감정·키워드 추출)

---

💡 핵심 인사이트 3줄 요약

1. MCP는 mcp_servers 리스트에 등록만 하면 AI가 알아서 조합 활용하며, 업무에 딱 맞는 MCP만 선별하는 것이 하네스 엔지니어링의 핵심이다.
2. 프롬프트 엔지니어링 → 하네스 엔지니어링으로 패러다임이 전환 중이다.
3. 구조화된 출력은 BaseModel + output_type + Field로 비정형 → 정형 변환의 핵심 기술이다.