피드로 돌아가기
Dev.toDevOps
원문 읽기
MCP 서버의 단순 기동 확인을 넘어선 실제 계약 검증 CI 게이트 구현
MCP CI gates need receipts: tools/list is not enough
AI 요약
Context
MCP 서버 검증 시 tools/list의 스키마 반환 여부만 확인하는 단순 헬스체크 방식의 한계 노출. 인증 오류, 권한 부족, 환경 변수 미설정 등 실제 런타임에서 발생하는 Degraded State를 탐지하지 못하는 구조적 결함 존재.
Technical Solution
- --fail-on-warn 플래그 도입을 통한 인증 핸드오프 및 권한 경고의 CI 블로킹 처리
- GitHub Actions 워크플로우 내 단일 스텝에서 설정 파일과 필수 플래그가 결합되었는지 확인하는 엄격한 Doctor 검증 로직 적용
- expectedTools 및 toolsFile 설정을 통한 도구 카탈로그 기반의 Tool Call Coverage 강제화
- 단순 스키마 검증을 넘어 실제 입력값과 기대 응답을 정의한 Sidecar Input 기반의 Dry-run 테스트 수행
- Read-only 역할의 작동 여부 및 데이터 유출 방지 등 세부적인 Assertion을 통한 실질적 계약 검증 체계 구축
실천 포인트
- MCP 서버 CI 구성 시 단순 프로세스 기동 확인 대신 실제 Tool Call 시나리오 포함 여부 검토 - Read-only 권한 및 Tenant Boundary 등 런타임 제약 사항을 검증하는 Assertion 세트 정의 - CI 파이프라인의 각 단계가 의도한 설정값(Config)과 플래그를 정확히 사용하고 있는지 검증하는 Meta-check 도입