OpenAPI MCP Server
by janwilmake
A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org. It helps users understand and utilize APIs by providing summaries and endpoint details in simple language.
Last updated: N/A
What is OpenAPI MCP Server?
The OpenAPI MCP Server is a tool that integrates with Claude and Cursor to facilitate the exploration and understanding of OpenAPI specifications. It leverages the Model Context Protocol to provide context about APIs, focusing on exploration rather than direct execution.
How to use OpenAPI MCP Server?
The server can be installed via Smithery or npx. Once installed, you can ask Claude to find information about specific APIs or explain how to use certain API endpoints. The server will then retrieve an overview of the requested API and provide details about specific operations.
Key features of OpenAPI MCP Server
Get an overview of any OpenAPI specification
Retrieve details about specific API operations
Support for both JSON and YAML formats
Tested with Claude Desktop and Cursor
Use cases of OpenAPI MCP Server
Exploring and understanding unfamiliar APIs
Generating code based on API specifications
Quickly finding relevant API endpoints for a specific task
Providing context to AI models like Claude and Cursor for better API utilization
FAQ from OpenAPI MCP Server
Does this server allow executing API endpoints directly?
Does this server allow executing API endpoints directly?
No, the current version (v2) focuses on exploration and providing context about APIs. Direct execution is not supported due to authentication challenges with MCP.
What is the difference between v1 and v2?
What is the difference between v1 and v2?
v2 is a Work In Progress and focuses on exploration and providing context about APIs. It does not allow executing the endpoints as tools directly, as authentication isn't a solved problem with MCP yet. However, it's great for codegen! v1 allowed direct execution.
What are the requirements for using this server?
What are the requirements for using this server?
You need Node.js >= 16.17.0 and Claude Desktop, Cursor, or any other MCP client.
Where can I find the documentation for v1?
Where can I find the documentation for v1?
The README for versions prior to v2.0.0 is available here.
Is this project open to contributions?
Is this project open to contributions?
Yes, the project is open to contributions. You can DM the author for more information.