피드로 돌아가기
Dev.toBackend
원문 읽기
MCP 도입을 통한 PWA 아이콘 생성 워크플로우의 Single-Tool 통합
i added MCP support to my SaaS in an afternoon. here's the whole thing.
AI 요약
Context
기존 PWA 아이콘 생성 과정은 브라우저 전환, 수동 다운로드, 파일 배치 등 파편화된 수동 작업으로 인한 컨텍스트 스위칭 비용 발생. REST API 기반의 SaaS 서비스가 존재하나 터미널 기반 개발 환경과의 통합 부재로 인한 병목 지점 존재.
Technical Solution
- FastMCP 기반의 서버 구축을 통한 AI 에이전트 전용 Tool 정의 및 노출
- 4단계의 API 호출 과정(이미지 생성 → 리사이징 → 저장 → 다운로드)을 하나의
generate_pwa_icons함수로 추상화한 Pipeline 설계 - HTTPX Client의 Timeout 설정을 300초로 확장하여 고부하 이미지 생성 작업 중 발생하는 Connection Drop 방지
- MCP 서버를 Long-lived Process로 설계하여 부팅 시 1회 인증 후 세션을 재사용하는 Global Client 구조 채택
- LLM의 판단 정확도를 높이기 위해 모호함을 제거한 명시적 Docstring 작성 및 텍스트 기반 Response 반환 구조 적용
실천 포인트
- API 경로 설계 시 파일 구조와 실제 배포 URL의 일치 여부를 Network Tab에서 직접 검증할 것 - AI Tool 설계 시 중간 단계의 데이터(ID, Key 등)가 사용자에게 불필요하다면 복수 Tool보다 단일 통합 Pipeline Tool로 제공할 것 - LLM이 도구를 호출하는 기준이 되는 Docstring의 구체성이 도구 선택의 정확도와 직결됨을 인지할 것 - 외부 API 연동 시 기본 Timeout 설정이 무거운 연산 작업(AI 생성 등)을 처리하기에 충분한지 검토할 것