mockd가 MCP 도구로 AI 에이전트에게 로컬 mock 서버 관리 능력을 부여해 외부 API 통합 코드의 테스트 루프 자동화

Context

AI 코딩 에이전트는 외부 API 호출 코드(Stripe, OAuth, webhook 등)를 작성할 때 실제 API가 로컬에 존재하지 않아 생성된 코드를 실행하고 검증할 수 없다. 에이전트가 작성한 코드는 구조적으로 완벽해도 실제 네트워크 응답에 대해 테스트되지 않은 상태로 남는다. 개발자가 매번 수동으로 테스트 계정 설정, API 키 관리, webhook 페이로드 검사를 담당해야 한다.

Technical Solution

• MCP(Model Context Protocol) 표준에 기반한 MCP 서버로 mockd 구현: stdio를 통해 AI 에이전트가 외부 도구를 프로그래밍 방식으로 호출 가능하도록 지원
• 18개 내장 MCP 도구 제공: manage_mock로 mock 엔드포인트 생성/수정/삭제, verify_mock으로 호출 횟수 검증, get_mock_invocations로 요청 본문과 헤더 확인
• 자동 백그라운드 데몬 시작: MCP 설정 추가 후 에이전트가 처음 접속할 때 mockd가 자동으로 포트 4280(mock 서버), 4290(admin API)에서 실행되어 별도 수동 시작 불필요
• 실제 HTTP 응답 제공: 에이전트가 생성한 코드가 localhost:4280으로 요청을 보내면 실제 JSON 본문을 받아 테스트 루프 실행
• 혼돈 주입 도구(set_chaos_config): 에이전트가 500 에러, 지연, 연결 실패를 주입해 에러 처리 및 재시도 로직 검증

Key Takeaway

AI 에이전트에게 외부 API mock 서버를 프로비저닝하고 관리하는 권한을 부여하면 개발자의 수동 개입 없이도 통합 코드의 전체 테스트 루프를 자동화할 수 있다. 실제 HTTP 응답에 대한 검증과 혼돈 주입을 통한 에러 처리 시뮬레이션을 에이전트가 독립적으로 수행하도록 설계하는 것이 핵심이다.