MCP.so
Sign In

@openapi-mcp/server

@sotayamashita

Repository

About @openapi-mcp/server

Powerful bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). Automatically converts any OpenAPI/Swagger API specification into MCP tools that can be used by AI assistants like Claude Desktop.

#api#cli#ai#server#tool#mcp#swagger#openapi#bridge#oas#llm#model-context-protocol#mcp-server#mcp-tools

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openapi-mcp-server-sotayamashita": {
      "command": "bun",
      "args": [
        "run",
        "src/index.ts",
        "./path/to/openapi.yml"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

FAQ from @openapi-mcp/server

What OpenAPI versions and authentication methods are supported?

OpenAPI v3.0.0 and v3.1.0 are supported. Authentication includes HTTP Basic, static Bearer tokens, and header-based API keys. OpenAPI v2.0 (Swagger), OAuth 2.0, OpenID Connect, query param API keys, cookie auth, and dynamic JWT are not supported.

Is an operationId required for every operation?

Yes, every operation in your specification must have a unique operationId. The server will fail to start or process the specification if any operation is missing this field.

What are the runtime dependencies for @openapi-mcp/server?

The server requires Bun as the JavaScript runtime. Dependencies are installed via bun install. The server runs as a CLI process via MCP’s stdio transport.

How do I configure the server for use with Claude Desktop?

Add the server to your Claude Desktop configuration, specifying the bun command and path to the server script, along with the required BASE_URL environment variable and optional HEADERS for authentication.

Frequently asked questions

What OpenAPI versions and authentication methods are supported?

OpenAPI v3.0.0 and v3.1.0 are supported. Authentication includes HTTP Basic, static Bearer tokens, and header-based API keys. OpenAPI v2.0 (Swagger), OAuth 2.0, OpenID Connect, query param API keys, cookie auth, and dynamic JWT are not supported.

Is an `operationId` required for every operation?

Yes, every operation in your specification must have a unique `operationId`. The server will fail to start or process the specification if any operation is missing this field.

What are the runtime dependencies for @openapi-mcp/server?

The server requires Bun as the JavaScript runtime. Dependencies are installed via `bun install`. The server runs as a CLI process via MCP’s stdio transport.

How do I configure the server for use with Claude Desktop?

Add the server to your Claude Desktop configuration, specifying the `bun` command and path to the server script, along with the required `BASE_URL` environment variable and optional `HEADERS` for authentication.

Comments

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

sotayamashita

More Developer Tools MCP servers

Meticulous

Meticulous

MCP server and skills to connect to the Meticulous UI testing platform.

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

directree

coburn2716

directree MCP server — query the honest software directory from any AI assistant

CircleCI MCP Server

CircleCI

Manage CI/CD pipelines, debug failed builds, and optimize test suites directly from your AI agents - no terminal required. The CircleCI MCP Server is a remote server hosted by CircleCI that connects AI tools and agents

Agent Conductor

icohangar-ops

Agent conductor — AGENTS.md contract parser, SKILL.md registry, CHP decision engine over MCP