OpenAPI 스키마 모델 컨텍스트 프로토콜 서버

Claude와 같은 대규모 언어 모델(LLM)에 OpenAPI 스키마 정보를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 LLM은 특수 도구 세트를 통해 OpenAPI 사양을 탐색하고 이해할 수 있습니다.

특징

명령줄 인수를 통해 지정된 OpenAPI 스키마 파일(JSON 또는 YAML)을 로드합니다.
API 경로, 작업, 매개변수 및 스키마 탐색
자세한 요청 및 응답 스키마 보기
구성 요소 정의 및 예제를 찾아보세요
전체 API 사양 검색
더 나은 LLM 이해를 위해 YAML 형식으로 응답을 받으세요

Related MCP server: mcp-graphql-schema

용법

명령줄

특정 스키마 파일로 MCP 서버를 실행합니다.

지엑스피1

Claude 데스크톱 통합

Claude Desktop과 함께 이 MCP 서버를 사용하려면 claude_desktop_config.json 구성 파일을 편집하세요.

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

구성 파일의 위치:

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: $env:AppData\Claude\claude_desktop_config.json

클로드 코드 통합

Claude Code CLI와 함께 이 MCP 서버를 사용하려면 다음 단계를 따르세요.

Claude Code에 OpenAPI Schema MCP 서버 추가
# Basic syntax claude mcp add openapi-schema npx -y mcp-openapi-schema # Example with specific schema claude mcp add petstore-api npx -y mcp-openapi-schema ~/Projects/petstore.yaml
MCP 서버가 등록되었는지 확인하세요
# List all configured servers claude mcp list # Get details for your OpenAPI schema server claude mcp get openapi-schema
필요한 경우 서버를 제거하세요
claude mcp remove openapi-schema
Claude Code에서 도구를 사용하세요
구성이 완료되면 Claude Code 세션에서 OpenAPI 스키마에 대한 질문을 통해 도구를 호출할 수 있습니다.

팁:

구성이 저장되는 위치를 지정하려면 project (기본값) 또는 global 과 함께 -s 또는 --scope 플래그를 사용합니다.
다양한 이름을 가진 다양한 API에 대해 여러 MCP 서버를 추가합니다.

MCP 도구

서버는 LLM이 OpenAPI 스키마와 상호 작용할 수 있도록 다음과 같은 도구를 제공합니다.

list-endpoints : 중첩된 객체 구조로 요약된 모든 API 경로와 해당 HTTP 메서드를 나열합니다.
get-endpoint : 매개변수와 응답을 포함한 특정 엔드포인트에 대한 자세한 정보를 가져옵니다.
get-request-body : 특정 엔드포인트 및 메서드에 대한 요청 본문 스키마를 가져옵니다.
get-response-schema : 특정 엔드포인트, 메서드 및 상태 코드에 대한 응답 스키마를 가져옵니다.
get-path-parameters : 특정 경로에 대한 매개변수를 가져옵니다.
list-components : 모든 스키마 구성 요소(스키마, 응답, 매개변수 등)를 나열합니다.
get-component : 특정 구성 요소에 대한 자세한 정의를 가져옵니다.
list-security-schemes : 사용 가능한 모든 보안 체계를 나열합니다.
get-examples : 특정 구성 요소 또는 엔드포인트에 대한 예를 가져옵니다.
search-schema : 경로, 작업 및 스키마를 검색합니다.

예시

시도해 볼 수 있는 쿼리 예시:

What endpoints are available in this API? Show me the details for the POST /pets endpoint. What parameters does the GET /pets/{petId} endpoint take? What is the request body schema for creating a new pet? What response will I get from the DELETE /pets/{petId} endpoint? What schemas are defined in this API? Show me the definition of the Pet schema. What are the available security schemes for this API? Are there any example responses for getting a pet by ID? Search for anything related to "user" in this API.