clean
목적
캐시된 원격 명세와 저장된 API 호출 응답을 제거합니다. 디스크 공간을 확보하고 다음 update 또는 mcp 시작 시 명세 파일을 새로 다운로드하도록 합니다.
사용 시기
- 원격 서버에서 명세 파일이 변경되어 강제로 새로고침하려고 할 때
- 디스크 공간을 확보하려고 할 때
- 오래된 캐시 문제를 해결할 때
update실행 전에 깨끗한 재캐싱을 보장하려고 할 때
구문
bash
swag2mcp clean [path]인수
| 인수 | 위치 | 필수 | 설명 |
|---|---|---|---|
path | 1 | 아니요 | 워크스페이스 디렉토리. 생략 시 경로 해결 규칙에 따라 결정됩니다. |
플래그
없음.
작동 방식
bash
swag2mcp clean
swag2mcp clean ./my-workspace정리되는 항목
| 디렉토리 | 내용 | 이유 |
|---|---|---|
cache/ | 다운로드된 원격 명세 파일 | 다음 접근 시 재다운로드 강제 |
responses/ | 저장된 API 호출 응답 | 디스크 공간 확보 |
보존되는 항목
| 디렉토리 | 내용 | 이유 |
|---|---|---|
specs/ | 로컬 명세 파일 | 소스 파일, 캐시가 아님 |
auth_scripts/ | 인증 스크립트 | 사용자가 생성한 것, 캐시가 아님 |
고아 인증 스크립트 정리
정리 후 clean은 설정에 더 이상 존재하지 않는 spec의 인증 스크립트도 제거합니다. 이는 오래된 스크립트가 쌓이는 것을 방지합니다.
자동 정리
MCP 서버가 시작될 때(swag2mcp mcp) 48시간보다 오래된 응답이 자동으로 제거됩니다. 일상적인 유지보수를 위해 수동으로 clean을 실행할 필요는 없습니다.
명령 후 검증
bash
ls ~/.swag2mcp/cache
# 비어 있어야 함 (디렉토리는 존재하지만 파일이 없음)세부 사항
- 설정 불필요:
clean은 유효한 설정 파일 없이도 작동합니다. 단순히 캐시와 응답 디렉토리를 제거합니다. - 고아 정리는 최선의 노력: 설정 파일이 손상되었거나 읽을 수 없는 경우 고아 인증 스크립트 정리는 건너뜁니다(치명적이지 않음).
- 디렉토리는 보존됨:
cache/와responses/디렉토리 자체는 유지되며 내용만 제거됩니다.