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.
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.
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.
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.
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.
hannesj/mcp-openapi-schema
March 13, 2025
March 28, 2025
JavaScript