mcp-openapi-schema

This repository provides a Model Context Protocol (MCP) server that exposes OpenAPI schema information to Large Language Models, enabling them to explore and understand API specifications through specialized tools.

32
2

OpenAPI Schema Model Context Protocol Server

This is a Model Context Protocol (MCP) server designed to expose OpenAPI schema information to Large Language Models (LLMs) like Claude, enabling them to understand and interact with API specifications through specialized tools.

Features

It loads OpenAPI schema files (JSON or YAML) via command-line arguments, allowing exploration of API paths, operations, parameters, and schemas. Users can view detailed request/response schemas, look up component definitions/examples, search the API specification, and receive responses in YAML for better LLM comprehension.

Usage

The server can be run via the command line, specifying the OpenAPI schema file path. It integrates with Claude Desktop by adding a configuration entry with the command to execute the server. For Claude Code CLI, the claude mcp command is used to add, list, get, and remove the server configuration.

MCP Tools

The server provides tools like list-endpoints, get-endpoint, get-request-body, get-response-schema, get-path-parameters, list-components, get-component, list-security-schemes, get-examples, and search-schema for LLMs to interact with OpenAPI schemas.

Repository

HA
hannesj

hannesj/mcp-openapi-schema

Created

March 13, 2025

Updated

March 28, 2025

Language

JavaScript

Category

AI