Swagger/OpenAPI 명세 파일에서 직접 MCP 도구 정의를 생성하세요.

OpenAPI-MCP는 도커화된 MCP 서버로, swagger.json 또는 openapi.yaml 파일을 읽고 대응하는 모델 컨텍스트 프로토콜(MCP) 도구 세트를 생성합니다. 이를 통해 Cursor와 같은 MCP 호환 클라이언트가 표준 OpenAPI 명세에 정의된 API와 상호작용할 수 있습니다. 이제 AI 에이전트가 OpenAPI/Swagger 명세만 제공하면 추가 코딩 없이 어떤 API든 접근할 수 있습니다.

목차

• 왜 OpenAPI-MCP인가요?
• 특징
• 설치
• 미리 구축된 Docker 허브 이미지 사용 (권장)
• 지역 건축 (선택 사항)
• 웨더비트 예제 실행 (단계별 설명)
• 명령줄 옵션
• 환경 변수

데모

직접 데모를 실행해 보세요: Weatherbit 예제 실행 (단계별로 진행)

왜 OpenAPI-MCP인가요?

• 표준 준수: 기존의 OpenAPI/Swagger 문서를 활용하세요.
• 자동 도구 생성: 각 엔드포인트에 대해 수동 설정 없이 MCP 도구를 생성합니다.
• 유연한 API 키 처리: 프록시 API의 API 키 인증을 안전하게 관리하며, MCP 클라이언트에 키를 노출하지 않습니다.

OpenAPI-MCP: Dockerized MCP Server to allow your AI agent to access any API with existing api docs

Generate MCP tool definitions directly from a Swagger/OpenAPI specification file.

OpenAPI-MCP is a dockerized MCP server that reads a swagger.json or openapi.yaml file and generates a corresponding Model Context Protocol (MCP) toolset. This allows MCP-compatible clients like Cursor to interact with APIs described by standard OpenAPI specifications. Now you can enable your AI agent to access any API by simply providing its OpenAPI/Swagger specification - no additional coding required.

Table of Contents

• Why OpenAPI-MCP?
• Features
• Installation
  • Using the Pre-built Docker Hub Image (Recommended)
  • Building Locally (Optional)
• Running the Weatherbit Example (Step-by-Step)
• Command-Line Options
  • Environment Variables

Demo

Run the demo yourself: Running the Weatherbit Example (Step-by-Step)

Why OpenAPI-MCP?

• Standard Compliance: Leverage your existing OpenAPI/Swagger documentation.
• Automatic Tool Generation: Create MCP tools without manual configuration for each endpoint.
• Flexible API Key Handling: Securely manage API key authentication for the proxied API without exposing keys to the MCP client.
• Local & Remote Specs: Works with local specification files or remote URLs.
• Dockerized Tool: Easily deploy and run as a containerized service with Docker.

Features

• OpenAPI v2 (Swagger) & v3 Support: Parses standard specification formats.
• Schema Generation: Creates MCP tool schemas from OpenAPI operation parameters and request/response definitions.
• Secure API Key Management:
  • Injects API keys into requests (header, query, path, cookie) based on command-line configuration.