mcp-registry/ReAPI-com/mcp-openapi

    ==================
      
       /// MCP ///
      /// REA ///
        
    ==================
        
    [server:online]
    [protocol:ready]

ReAPI-com/mcp-openapi

by ReAPI-com

MCP server that scans a directory of OpenAPI 3.x specs, builds a searchable catalog (operations & schemas) and exposes it through the Model Context Protocol for LLM-powered IDEs such as Cursor.

56
9
Open Source
GitHubWebsite

01

refresh-api-catalog

Refresh the API catalog of all loaded OpenAPI specifications

02

get-api-catalog

Retrieve the complete API catalog, including metadata for all specifications, operations, and schemas

03

search-api-operations

Search for API operations across specifications, optionally filtered by specification ID

04

search-api-schemas

Search for API schemas across specifications, optionally filtered by specification ID

05

load-api-operation-by-operationId

Load detailed information for a specific API operation identified by its operationId within a given specification

06

load-api-operation-by-path-and-method

Load detailed information for a specific API operation using its endpoint path and HTTP method within a given specification

07

load-api-schema-by-schemaName

Load detailed information for a specific API schema by its schemaName within a given specification

Installation

1. Prerequisites
• Node.js 18 or later
• Git
2. Clone the repository
git clone https://github.com/ReAPI-com/mcp-openapi.git cd mcp-openapi
3. Install dependencies
npm install
4. Build the TypeScript sources (if any helpers/scripts exist)
npm run build # compiles to ./dist
5. Serve the OpenAPI file locally (optional)
# With Swagger-UI npx swagger-ui-watcher ./openapi.yaml --port 3000 # Or with Redoc npx redoc-cli serve ./openapi.yaml
6. Deploy with any HTTP server
• Copy the generated `openapi.yaml` (or `json`) to your MCP server project.
• Ensure your MCP server exposes the spec at `/openapi` or similar.
Environment configuration
• PORT – The port your HTTP server should bind to (default 3000).
• BASE_URL – Public URL that clients will use (used inside the spec servers block).
Updating the spec
# edit ./openapi.yaml or ./src/**/*.ts then rebuild npm run build git commit -m "chore: update spec" git push

Documentation

License: MIT License
Updated 7/30/2025