MCP Catalogs
← Home

mcp-openapi

by ReAPI-com·★ 86·Score 41

MCP server that loads and serves OpenAPI specifications to enable LLM-powered API integrations in IDEs.

developer-toolsai-llm
16
Forks
7
Open issues
14 mo ago
Last commit
2d ago
Indexed

Overview

@reapi/mcp-openapi is a Model Context Protocol server that bridges OpenAPI specifications with LLM-powered development environments. It loads multiple OpenAPI files from a directory, dereferences schemas for complete context, and exposes API operations through MCP. The server enables intelligent code completion, API-aware code generation, and integration assistance in tools like Cursor IDE.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Generate API-aware code snippets and clients in IDEs
you:Provide context-aware code completion for API endpoints
you:Automate API documentation generation from OpenAPI specs
you:What OpenAPI versions are supported?
you:How do I handle multiple API specs with similar paths?

When to choose this

Choose this server when working with multiple OpenAPI specs and need LLM integration in your IDE for API documentation, client generation, or schema understanding.

When NOT to choose this

Don't choose this if you need real-time API mocking or testing capabilities, as this server focuses on static API documentation and schema information.

Tools this server exposes

7 tools extracted from the README
  • refresh-api-catalog

    Refresh the API catalog

  • get-api-catalog

    Get the complete API catalog with all specifications, operations, and schemas

  • search-api-operations

    Search for API operations across specifications

  • search-api-schemas

    Search for schemas across specifications

  • load-api-operation-by-operationId

    Load an API operation by operation ID

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

    Load an API operation by path and HTTP method

  • load-api-schema-by-schemaName

    Load an API schema by schema name

Comparable tools

swagger-mcpapi-spec-mcpopenapi-generator-cliredoc

Installation

Install the MCP server using npm:

npm install -g @reapi/mcp-openapi

Configure in Cursor IDE by creating .cursor/mcp.json:

{
  "mcpServers": {
    "@reapi/mcp-openapi": {
      "command": "npx",
      "args": ["-y", "@reapi/mcp-openapi@latest", "--dir", "./specs"],
      "env": {}
    }
  }
}

Place your OpenAPI specifications in the ./specs directory and enable the server in Cursor Settings > MCP.

FAQ

What OpenAPI versions are supported?
The server supports OpenAPI 3.x specifications in both JSON and YAML formats with .json, .yaml, or .yml extensions.
How do I handle multiple API specs with similar paths?
Use the 'x-spec-id' field in your OpenAPI info object to assign custom IDs to your specifications, which helps distinguish between similar resources.

On Hacker News

Recent discussion from the developer community.

Compare mcp-openapi with

mcp-openapi vs ultimate_mcp_servermcp-openapi vs mcp-server-chartmcp-openapi vs everythingmcp-openapi vs filesystemmcp-openapi vs time
GitHub →

Last updated · Auto-generated from public README + GitHub signals.