Parses OpenAPI/Swagger specifications and exposes semantic tools for exploring API structure, endpoints, schemas, tags, and detailed operation information, enabling AI assistants to understand and navigate API documentation programmatically.
opamcp
OpenAPI MCP Server - OpenAPI 스펙을 MCP 도구로 노출하여 AI 어시스턴트가 API를 탐색할 수 있게 합니다.
설치 및 사용법
MCP 클라이언트 설정
Claude Desktop / Cursor
MCP 클라이언트 설정에 다음을 추가하세요:
제공되는 도구
도구 | 설명 | 파라미터 |
| API 기본 정보 조회 (title, version, description, servers) | - |
| 모든 태그(API 그룹) 목록 조회 | - |
| 모든 엔드포인트 요약 목록 조회 | - |
| 특정 태그에 속한 엔드포인트 조회 |
|
| 엔드포인트 상세 정보 조회 (파라미터, 요청, 응답, 스키마 등) |
,
|
| components/schemas의 모든 스키마 이름 조회 | - |
| 특정 스키마 정의 조회 |
|
| path, summary, operationId로 엔드포인트 검색 |
|
권장 사용 흐름
get_api_info- API가 무엇인지 파악list_tags- API 구조 파악list_endpoints또는get_endpoints_by_tag- 관련 엔드포인트 찾기get_endpoint_detail- 특정 엔드포인트 상세 정보 확인list_schemas→get_schema- 데이터 타입 탐색
개발
라이선스
MIT
English
OpenAPI MCP Server - Expose OpenAPI specs as MCP tools for AI assistants.
This MCP server parses an OpenAPI specification and provides semantic tools that allow AI assistants to explore and understand APIs step by step.
Installation & Usage
MCP Client Configuration
Claude Desktop / Cursor
Add to your MCP client configuration:
Available Tools
Tool | Description | Parameters |
| Get API basic info (title, version, description, servers) | - |
| List all tags (API groups) | - |
| List all endpoints with summary | - |
| Get endpoints filtered by tag |
|
| Get detailed endpoint info (params, request, response, schemas) |
,
|
| List all schema names in components/schemas | - |
| Get full schema definition |
|
| Search endpoints by path, summary, or operationId |
|
Recommended Usage Flow
get_api_info- Understand what the API is aboutlist_tags- See how the API is organizedlist_endpointsorget_endpoints_by_tag- Find relevant endpointsget_endpoint_detail- Get detailed information about a specific endpointlist_schemas→get_schema- Explore data types
Development
License
MIT