🔄
멀티 서비스 전환
채팅으로 여러 API 서비스를 즉시 전환하세요. swagger-targets.json 설정으로 MSA 환경에 최적화되어 있습니다.
Swagger MCP 서버채팅으로 하는 API 개발
AI와 대화하며 Swagger/OpenAPI를 탐색하고 API를 테스트하세요. Postman이 필요 없습니다.
Skip to content
빠른 시작
bash
# 설치 없이 바로 사용
npx @zerry_jin/swagger-mcp그런 다음 Claude에게 요청하세요:
"petstore API에 연결하고 모든 pet 엔드포인트를 보여줘"
사용 가능한 도구
🔌 서비스 관리
| 도구 | 설명 |
|---|---|
swagger_select_service | 서비스 선택 (설정 파일의 alias 또는 직접 URL) |
swagger_list_services | 등록된 서비스 목록 조회 |
swagger_get_current | 현재 서비스 정보 표시 |
🔍 API 탐색
| 도구 | 설명 |
|---|---|
swagger_list_endpoints | 모든 엔드포인트 나열 (태그 필터 가능) |
swagger_get_endpoint | 엔드포인트 상세 정보 (파라미터, 바디, 응답) |
swagger_search | 키워드로 엔드포인트 검색 |
📊 스키마 조회
| 도구 | 설명 |
|---|---|
swagger_get_schema | 스키마/DTO 구조 조회 |
swagger_list_schemas | 모든 스키마 목록 |
🧪 API 테스트
| 도구 | 설명 |
|---|---|
swagger_test | 실제 HTTP 요청 실행 |
swagger_curl | cURL 명령어 생성 |
왜 필요한가요?
MSA 환경에서 여러 서비스의 API 문서를 오가며 개발하는 것은 번거롭습니다.
이 MCP 서버를 사용하면:
- 서비스 전환이 자유로움 - 채팅으로 "payment 서버 연결해줘"
- API 직접 테스트 - Postman 없이 채팅에서 바로 호출
- cURL 자동 생성 - 복사해서 터미널에 붙여넣기
- 스키마/DTO 조회 - TypeScript 인터페이스 생성에 활용
- 동적 URL 지원 - 설정 없이 바로 URL 입력 가능