What is @openapi-mcp/server?
@openapi-mcp/server is a bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). It automatically converts any OpenAPI/Swagger API specification into MCP tools that AI assistants like Claude Desktop can use to interact with your APIs. It is for developers who want to make their REST APIs accessible to AI assistants without custom integrations.
How to use @openapi-mcp/server?
Clone the repository, install dependencies with bun install, then run bun run src/index.ts with a path to a local OpenAPI file or --api with a URL. Configure the required BASE_URL environment variable and optional HEADERS environment variable. Integrate with Claude Desktop or Cursor by adding the server to their MCP configuration.
Key features of @openapi-mcp/server
- Automatically converts OpenAPI/Swagger specs into MCP tools
- Supports OpenAPI v3.0.0 and v3.1.0
- Supports HTTP Basic, Bearer token, and header-based API key auth
- Works with local files or remote API specification URLs
- Configurable custom HTTP headers
Use cases of @openapi-mcp/server
- AI assistants performing real-world actions through your APIs
- Converting any REST API with an OpenAPI spec into AI-accessible tools
- Enabling Claude Desktop to interact with custom services without custom integrations
Comments