mcp-openapi-explorer

mcp-openapi-explorer

1
developer_toolsdatabases

MCP OpenAPI Explorer is a server that processes OpenAPI specifications to provide detailed context for API interactions. It supports both JSON and YAML formats and is designed for seamless integration with LLMs, offering features like intelligent API endpoint insights and structured logging.

MCP OpenAPI Explorer

A Model Context Protocol (MCP) server dedicated to analyzing OpenAPI specifications and offering interactive context for API engagements.

Features

  • Load OpenAPI specifications from GitHub, local files, and HTTP URLs.
  • Parse and offer complete context for API endpoints.
  • Support MCP via stdin/stdout.
  • Provide intelligent context for LLMs.
  • Support JSON and YAML OpenAPI specifications.
  • Built with Cobra CLI for command-line ease.
  • Structured logging with Zap.

Getting Started

Prerequisites

  • Go 1.24.2 or later
  • Docker (optional)

Installation

  1. Clone the repository and install dependencies.
  2. Build the project.

Configuration

  • Modify your YAML configuration file for personalization.
  • GitHub token setup for private repositories and rate-limit avoidance.

MCP Usage

  • Operates through stdin/stdout for LLM integration.

Available MCP Tools

  • get_api_info: Retrieve comprehensive API endpoint information.
  • load_api_spec: Load an OpenAPI specification via URL or file path.
  • list_api_specs: View all loaded OpenAPI specifications.
  • delete_api_spec: Erase a specific API specification.
  • refresh_api_spec: Refresh OpenAPI specifications by redownloading from source.