Mocktail: 무료 오픈 소스 목(mock) API 서버 및 내장 대시보드

박스에 포함된 대시보드.

매번 요청마다 신선하게 혼합됩니다.

앱이 예상하는 응답(헤더, 지연 시간, 심지어 불안정한 401)을 모델링하고 Mocktail이 데이터를 생생하게 유지하도록 하세요.

편집, 유효성 검사, 무작위화

Mocktail 내에서 JSON을 작성하고 유효성 검사할 수 있습니다. 응답을 고정하거나, 요청마다 새로운 값(uuid, email, price, name)을 생성하거나, 응답을 익명화해야 할 때 실제 필드를 가짜 데이터로 교체하세요.

모든 요청이 도착하는 것을 확인하세요

엔드포인트를 만들고 대시보드에서 바로 테스트를 실행하여 라이브 스트림에 표시되는 방식, 상태, 지연 시간, 그리고 제공된 정확한 응답 및 헤더를 확인하세요. 경로 또는 상태별로 필터링할 수 있습니다. 앱을 벗어나지 않고 전체 루프가 가능합니다.

복잡한 부분 모델링하기

실제 API는 항상 만족스러운 200이 아닐 때도 있습니다. Retry-After와 함께 429를 반환하거나, 800ms의 지연 시간을 추가하거나, problem+json 오류를 제공하세요. 앱이 처리해야 하는 모든 것을 말입니다.

HTTP/1.1 429 Too Many Requests Retry-After: 30 Content-Type: application/problem+json X-RateLimit: 0/100

작성하고, 타이핑하지 마세요

사용자 지정 키를 가져오세요. 평이한 언어로 원하는 것을 말하면 Mocktail이 Claude를 사용하여 대시보드 내에서 전체 응답을 초안합니다. 사용자의 키는 절대 기기를 벗어나지 않으며, 채팅 기록도 저장되지 않습니다.

{ "id": "ord_8a2f", "items": 3, "total": "$84.20" }

또는 AI 도구에 구동되게 하세요

내장 MCP 서버는 Mocktail을 Claude Desktop & Code와 연결합니다. 질문하면, 그들이 당신을 위해 목(mock)을 생성하고 편집해 줍니다. 문장 하나가 라이브 엔드포인트가 되며, 대시보드가 필요하지 않습니다.

언제 사용할지 알려드립니다.

첫 프론트엔드 커밋부터 데모일까지 전체 수명 주기 동안 사용 가능한 하나의 도구입니다.

백엔드가 아직 없을 때

실제 API가 따라잡는 동안 프론트엔드를 계속 구축하세요.

보기 싫은 것들을 테스트할 때

느린 응답, 401 · 429 · 500, 속도 제한, 엣지 케이스 등 실제 것을 망가뜨리지 않고도 테스트할 수 있습니다.

데모 당일이 무너질 수 없을 때

데모, 프로토타입, 워크숍 또는 QA를 위한 안정적이고 독립적인 API입니다.

AI에게 설정을 맡기세요. 내장 어시스턴트나 MCP를 통해 사용자 지정 에이전트를 가져오세요.

첫 번째 사용처.

대시보드는 macOS, Linux, Windows에서 함께 제공됩니다. localhost:6625로 접속하여 목킹을 시작하세요.

질문에 답하다.

Mocktail이란 무엇인가요?

Mocktail은 내장 대시보드를 갖춘 자체 호스팅(self-hosted) 목 API 서버이며, 단일 바이너리 형태로 제공됩니다. 엔드포인트와 응답을 정의한 다음, 실제 API처럼 앱에서 호출할 수 있습니다. 로컬에서 실행하거나 자체 인프라에 배포할 수 있습니다.

Mocktail은 무료이고 오픈 소스인가요?

네. Mocktail은 GitHub에서 무료로 사용할 수 있는 오픈 소스입니다. 가입이나 유료 등급이 필요 없으며, 노트북이나 자체 서버에서 실행할 수 있습니다.

Mocktail을 어떻게 설치하나요?

Homebrew(brew install --cask Huseyinnurbaki/tap/mocktail)로 설치하거나, Docker를 사용하거나, 바이너리를 직접 다운로드하여 설치할 수 있습니다. 로컬 설치 시 기본적으로 localhost:6625에서 대시보드가 열립니다. 네이티브 데스크톱 앱은 곧 출시될 예정입니다.

제 데이터는 어디에 저장되나요?

Mocktail을 실행하는 곳에 저장됩니다. 데이터는 사용자의 기기 또는 Docker를 사용할 때 마운트된 볼륨의 단일 SQLite 파일에 저장됩니다. Mocktail로 아무것도 전송되지 않으며, 원격 측정(telemetry) 기능도 없습니다. 목킹 데이터는 JSON으로 내보내서 커밋하거나 공유할 수도 있습니다.

Mocktail은 현실적인 테스트 데이터를 생성할 수 있나요?

네, 선택적으로 가능합니다. 응답을 그대로 고정된 값으로 제공하거나, UUID, 이메일, 가격, 이름 등 개별 필드에 생성기(generators)를 연결하여 요청마다 새로운 값을 받을 수 있습니다. 기존 응답의 필드를 생성된 데이터로 대체할 수도 있습니다.

Mocktail은 AI 도구와 작동하나요?

네. 내장 AI 어시스턴트는 자체 API 키를 사용하여 일반 언어 프롬프트로부터 응답 초안을 작성할 수 있으며, MCP 서버는 Claude Desktop이나 Claude Code 같은 도구가 목킹 데이터를 직접 생성하고 관리하도록 합니다.

팀이 Mocktail 인스턴스를 공유할 수 있나요?

네. Docker 이미지를 팀이 접근할 수 있는 인프라에 배포하여 개발, 테스트 및 데모 전반에 걸쳐 동일한 Mocktail 인스턴스를 사용할 수 있습니다.