DOCSEARCHbyAlgolia
Submit Docs

openapi-mcp-server

repository·main·Indexed 21 days ago

https://github.com/janwilmake/openapi-mcp-server

An MCP server that enables Claude and Cursor to interact with OpenAPI specifications by searching and exploring them through oapis.org. It supports JSON and YAML formats, allowing AI models to obtain specification overviews and retrieve detailed operational information for specific API endpoints.

Tokens
337
Snippets
1
Records
3
Agent score
25%

What's inside openapi-mcp-server

  1. Overview of OpenAPI MCP Server

    main

    The OpenAPI MCP Server is a Model Context Protocol (MCP) server designed for use with Claude and Cursor. It allows AI models to search for and explore OpenAPI specifications via oapis.org.

    The server follows a three-step process to assist the AI:

    1. Identifies the required OpenAPI identifier.
    2. Requests a summary of the specification in natural language.
    3. Determines the necessary endpoints and retrieves detailed operational information in natural language.

    Key features include:

    • Obtaining overviews of any OpenAPI specification.
    • Retrieving details for specific API operations.
    • Support for both JSON and YAML formats.

  3. Test the OpenAPI MCP Server locally

    main

    To test the server locally, you need to run the server using Wrangler and then use the MCP Inspector to verify the connection.

    1. Start the server:
    wrangler dev
    1. Run the MCP inspector:
    npx @modelcontextprotocol/inspector
    wrangler dev
npx @modelcontextprotocol/inspector