Mock 서버 설치

swag2mcp-mock 바이너리는 가짜 응답으로 API를 테스트하기 위한 별도의 도구입니다. 메인 바이너리와 동일한 설치 방법을 지원합니다.

호환성

방법	macOS	Linux	Windows
한 줄 명령 (curl)	✅	✅	❌
Homebrew	✅	❌	❌
Scoop	❌	❌	✅
GitHub Release	✅	✅	✅
go install	✅	✅	✅
소스에서 빌드	✅	✅	✅
Docker	✅	✅	✅

---

macOS

한 줄 명령 (권장)

두 가지 설치 모드 — 적합한 방식을 선택하세요:

# sudo 사용 (/usr/local/bin에 설치 — 권장)
curl -fsSL https://swag2mcp.io/install-mock.sh | bash

# sudo 없이 (~/.local/bin에 설치)
curl -fsSL https://swag2mcp.io/install-mock.sh | bash -s -- --local

--sudo (기본값): sudo를 사용하여 /usr/local/bin/swag2mcp-mock에 설치합니다. 비밀번호를 입력하라는 메시지가 표시됩니다. sudo가 실패하면 ~/.local/bin/swag2mcp-mock으로 대체됩니다.

--local: sudo 없이 ~/.local/bin/swag2mcp-mock에 설치합니다. 설치 후 셸 구성에 추가하세요:

export PATH="$HOME/.local/bin:$PATH"

확인:

swag2mcp-mock --version

Homebrew

brew install mmadfox/tap/swag2mcp-mock

확인:

swag2mcp-mock --version

GitHub Release

1. 최신 릴리스 페이지 열기
2. Mac에 맞는 아카이브 다운로드:
   • Apple Silicon: swag2mcp-mock_darwin_arm64.tar.gz
   • Intel: swag2mcp-mock_darwin_amd64.tar.gz
3. 다운로드 폴더에서 터미널을 열고 실행:

tar -xzf swag2mcp-mock_darwin_*.tar.gz
sudo mv swag2mcp-mock /usr/local/bin/

확인:

swag2mcp-mock --version

go install

go install github.com/mmadfox/swag2mcp/cmd/swag2mcp-mock@latest

$GOPATH/bin이 $PATH에 있는지 확인하세요:

export PATH=$PATH:$(go env GOPATH)/bin

확인:

swag2mcp-mock --version

소스에서 빌드

git clone https://github.com/mmadfox/swag2mcp.git
cd swag2mcp
go build -o swag2mcp-mock ./cmd/swag2mcp-mock
sudo mv swag2mcp-mock /usr/local/bin/

확인:

swag2mcp-mock --version

Docker

~/.swag2mcp(또는 사용자 정의 워크스페이스 경로)를 /home/nonroot/.swag2mcp에 마운트하세요. 엔트리포인트가 자동으로 파일 권한을 조정하여 컨테이너가 워크스페이스를 읽을 수 있게 합니다.

docker pull ghcr.io/mmadfox/swag2mcp-mock:latest

Mock 서버 실행:

docker run --rm -i -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp-mock:latest

확인:

docker run --rm -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp-mock:latest --version

---

Linux

한 줄 명령 (권장)

두 가지 설치 모드 — 적합한 방식을 선택하세요:

# sudo 사용 (/usr/local/bin에 설치 — 권장)
curl -fsSL https://swag2mcp.io/install-mock.sh | bash

# sudo 없이 (~/.local/bin에 설치)
curl -fsSL https://swag2mcp.io/install-mock.sh | bash -s -- --local

--sudo (기본값): sudo를 사용하여 /usr/local/bin/swag2mcp-mock에 설치합니다. 비밀번호를 입력하라는 메시지가 표시됩니다. sudo가 실패하면 ~/.local/bin/swag2mcp-mock으로 대체됩니다.

--local: sudo 없이 ~/.local/bin/swag2mcp-mock에 설치합니다. 설치 후 셸 구성에 추가하세요:

export PATH="$HOME/.local/bin:$PATH"

확인:

swag2mcp-mock --version

GitHub Release

1. 최신 릴리스 페이지 열기
2. 아키텍처에 맞는 아카이브 다운로드:
   • amd64: swag2mcp-mock_linux_amd64.tar.gz
   • arm64: swag2mcp-mock_linux_arm64.tar.gz
3. 다운로드 폴더에서 터미널을 열고 실행:

tar -xzf swag2mcp-mock_linux_*.tar.gz
sudo mv swag2mcp-mock /usr/local/bin/

확인:

swag2mcp-mock --version

go install

go install github.com/mmadfox/swag2mcp/cmd/swag2mcp-mock@latest

$GOPATH/bin이 $PATH에 있는지 확인하세요:

export PATH=$PATH:$(go env GOPATH)/bin

확인:

swag2mcp-mock --version

소스에서 빌드

git clone https://github.com/mmadfox/swag2mcp.git
cd swag2mcp
go build -o swag2mcp-mock ./cmd/swag2mcp-mock
sudo mv swag2mcp-mock /usr/local/bin/

확인:

swag2mcp-mock --version

Docker

~/.swag2mcp(또는 사용자 정의 워크스페이스 경로)를 /home/nonroot/.swag2mcp에 마운트하세요. 엔트리포인트가 자동으로 파일 권한을 조정하여 컨테이너가 워크스페이스를 읽을 수 있게 합니다.

docker pull ghcr.io/mmadfox/swag2mcp-mock:latest

Mock 서버 실행:

docker run --rm -i -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp-mock:latest

확인:

docker run --rm -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp-mock:latest --version

---

Windows

Scoop

scoop bucket add mmadfox https://github.com/mmadfox/scoop-bucket
scoop install mmadfox/swag2mcp-mock

확인:

swag2mcp-mock --version

GitHub Release

1. 최신 릴리스 페이지 열기
2. swag2mcp-mock_windows_amd64.zip 다운로드
3. ZIP 파일 압축 풀기 (마우스 오른쪽 버튼 클릭 → 모두 추출, 또는 PowerShell 사용)
4. swag2mcp-mock.exe를 C:\Windows\System32\로 이동

확인:

swag2mcp-mock --version

go install

go install github.com/mmadfox/swag2mcp/cmd/swag2mcp-mock@latest

확인:

swag2mcp-mock --version

소스에서 빌드

git clone https://github.com/mmadfox/swag2mcp.git
cd swag2mcp
go build -o swag2mcp-mock.exe ./cmd/swag2mcp-mock

확인:

swag2mcp-mock --version

---

다음 단계

• 빠른 시작 — 2분 만에 시작하기
• Mock 서버 — Mock 서버 구성 및 실행