OpenAPI 스키마 MCP 서버

“OpenAPI 스키마” MCP 서버는 무엇을 하나요?

OpenAPI 스키마 MCP 서버는 Claude와 같은 대형 언어 모델(LLM)에 OpenAPI 스키마 정보를 노출하도록 설계된 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 OpenAPI 명세에 구조적으로 접근할 수 있도록 하여 AI 어시스턴트가 API의 엔드포인트, 파라미터, 요청 및 응답 스키마 등을 탐색하고 이해할 수 있게 합니다. 덕분에 개발자와 AI 도구는 API 구조를 질의하고, 명세 전체에서 검색하며, 상세한 스키마 정의를 조회할 수 있어 API 통합, 문서화, 코드 생성 워크플로우가 향상됩니다. 이 서버는 JSON 또는 YAML 형식의 OpenAPI 파일 로드를 지원하며, LLM의 이해를 돕기 위해 결과를 YAML로 제공합니다.

프롬프트 목록

저장소에 명시적인 프롬프트 템플릿이 문서화되어 있지 않습니다.

리소스 목록

저장소에 명시적인 리소스가 설명되어 있지 않습니다.

도구 목록

OpenAPI 스키마 MCP 서버는 LLM을 위해 다음과 같은 도구를 제공합니다:

• list-endpoints: API 경로와 HTTP 메서드를 요약과 함께 중첩 객체 구조로 나열합니다.
• get-endpoint: 특정 엔드포인트에 대한 파라미터, 응답 등 상세 정보를 조회합니다.
• get-request-body: 특정 엔드포인트와 HTTP 메서드의 요청 본문 스키마를 제공합니다.
• get-response-schema: 특정 엔드포인트, 메서드, 상태 코드에 대한 응답 스키마를 반환합니다.
• get-path-parameters: 특정 경로에 대한 파라미터를 조회합니다.
• list-components: 모든 스키마 컴포넌트(스키마, 응답, 파라미터 등)를 나열합니다.
• get-component: 특정 컴포넌트의 상세 정의를 반환합니다.
• list-security-schemes: API에서 사용 가능한 모든 보안 스키마를 나열합니다.
• get-examples: 특정 컴포넌트나 엔드포인트에 대한 예제를 조회합니다.
• search-schema: OpenAPI 명세 내 경로, 오퍼레이션, 스키마 전체를 검색합니다.

MCP 서버의 활용 사례

• API 탐색 및 문서화: 개발자 또는 LLM이 엔드포인트, 파라미터, 스키마를 빠르게 나열하여 API 구조를 쉽게 문서화하거나 이해할 수 있습니다.
• 자동 코드 생성: 요청 및 응답 스키마를 프로그래밍 방식으로 조회하여, 도구가 API 상호작용용 클라이언트 라이브러리 또는 코드 스니펫을 생성할 수 있습니다.
• API 테스트 및 검증: 테스트 도구가 파라미터와 예제 페이로드를 불러와 자동 또는 수동 API 테스트를 지원할 수 있습니다.
• 보안 검토: 엔드포인트별 보안 스키마와 구현을 분석하여 API가 적절히 보호되고 있는지 확인할 수 있습니다.
• 스키마 검색 및 분석: 대형 API 명세 내에서 특정 엔티티나 기능과 관련된 스키마 컴포넌트 또는 엔드포인트를 빠르게 찾고 분석할 수 있습니다.

설정 방법

Windsurf

Windsurf에 대한 설정 안내는 제공되지 않습니다.

Claude

1. Node.js와 npx가 설치되어 있는지 확인하세요.
2. Claude Desktop 설정 파일을 찾으세요:
   • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: $env:AppData\Claude\claude_desktop_config.json
3. mcpServers 오브젝트 아래에 OpenAPI 스키마 MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "OpenAPI Schema": {
         "command": "npx",
         "args": ["-y", "mcp-openapi-schema", "/ABSOLUTE/PATH/TO/openapi.yaml"]
       }
     }
   }
   

4. 파일을 저장하고 Claude Desktop을 재시작하세요.
5. Claude UI에서 서버가 사용 가능한지 확인하세요.

Cursor

Cursor에 대한 설정 안내는 제공되지 않습니다.

Cline

Claude Code CLI

1. Node.js와 npx가 설치되어 있는지 확인하세요.
2. OpenAPI 스키마 MCP 서버를 추가하세요:

   claude mcp add openapi-schema npx -y mcp-openapi-schema
   

   또는 특정 스키마 파일과 함께:

   claude mcp add petstore-api npx -y mcp-openapi-schema ~/Projects/petstore.yaml
   

3. 등록 확인:

   claude mcp list
   claude mcp get openapi-schema
   

4. 필요 시 서버 제거:

   claude mcp remove openapi-schema
   

5. Claude Code 세션에서 도구를 사용하세요.

API 키 보안

API 키 보안이나 환경 변수 사용에 대한 정보는 제공되지 않습니다.

이 MCP를 플로우에서 사용하는 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, 우선 플로우에 MCP 컴포넌트를 추가하고 이를 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭하여 설정 패널을 엽니다. 시스템 MCP 설정 섹션에 다음과 같은 JSON 형식으로 MCP 서버 정보를 입력하세요:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면 AI 에이전트는 MCP의 모든 기능과 역량을 도구로 사용할 수 있습니다. “MCP-name"은 실제 MCP 서버 이름(예: “github-mcp”, “weather-api” 등)으로, URL은 본인의 MCP 서버 주소로 변경하는 것을 잊지 마세요.

개요

제공 문서 기준, OpenAPI 스키마 MCP 서버는 LLM 기반 OpenAPI 탐색에 특화되어 강력한 도구 세트를 제공하지만, 프롬프트, 리소스, API 키 처리, 고급 MCP 기능에 대한 상세 정보는 부족합니다. OpenAPI 용도에는 강력하지만, 범용 MCP 기능에 있어서는 한계가 있습니다.

MCP 점수

평가:
이 MCP 서버에 6/10을 부여합니다. OpenAPI 스키마 탐색에 잘 정의되어 있고 도구 세트도 강력하지만, MCP 프롬프트 템플릿, 명시적 리소스 정의, 보안 모범 사례, 루트/샘플링 지원에 대한 문서화가 부족합니다. 또한 라이선스 부재는 오픈 협업에 중요한 제한점입니다.