MCP.so
Sign In

OpenAPI-MCP: Dockerized MCP Server to allow your AI agent to acc…

@ckanthony

Repository

About OpenAPI-MCP: Dockerized MCP Server to allow your AI agent to acc…

Dockerized MCP Server to allow your AI agent to access any API with existing api docs

Config

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

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "docker",
      "args": [
        "pull",
        "ckanthony/openapi-mcp:latest"
      ]
    }
  }
}

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?

OpenAPI-MCP is a Dockerized MCP server that reads a Swagger/OpenAPI specification file and automatically generates corresponding Model Context Protocol (MCP) tool definitions. It allows MCP-compatible clients like Cursor to interact with any API that has existing OpenAPI documentation, without additional coding.

How to use OpenAPI-MCP?

Install via Docker (pull ckanthony/openapi-mcp:latest from Docker Hub or build locally). Run the container with docker run, providing the spec file (local path or remote URL) and optional API key configuration via flags, environment variables, or a .env file. The server listens on port 8080 by default.

Key features of OpenAPI-MCP

  • Supports both OpenAPI v2 (Swagger) and v3 specifications.
  • Generates MCP tool schemas from operation parameters and definitions.
  • Securely injects API keys into requests without exposing them to the client.
  • Works with local spec files or remote URLs.
  • Includes filtering options for operations and tags.

Use cases of OpenAPI-MCP

  • Enable an AI assistant to call any public or private API that provides an OpenAPI specification.
  • Rapidly integrate a weather API (e.g., Weatherbit) with a Cursor agent using an existing Swagger file.
  • Automate tool generation for thousands of endpoints without manual configuration.
  • Securely proxy authenticated APIs to MCP clients while keeping keys hidden.

FAQ from OpenAPI-MCP

What OpenAPI versions does OpenAPI-MCP support?

OpenAPI-MCP supports both OpenAPI v2 (Swagger) and OpenAPI v3 specification formats.

How does OpenAPI-MCP handle API keys?

It injects API keys into requests (via header, query, path, or cookie) based on command-line flags. Keys can be provided directly, via environment variables, or from a local .env file, and are never exposed to the MCP client.

Can I use a remote OpenAPI specification?

Yes, you can pass a remote URL to the --spec flag. The server will fetch the specification and generate tools accordingly.

What runtime is required to run OpenAPI-MCP?

OpenAPI-MCP is Dockerized. The recommended approach is to use the pre-built Docker Hub image. For local development, you can build the image from source using Go.

How do I filter which endpoints become MCP tools?

Use the command-line flags --include-tag, --exclude-tag, --include-op, and --exclude-op to include or exclude specific operations or tag groups.

Frequently asked questions

What OpenAPI versions does OpenAPI-MCP support?

OpenAPI-MCP supports both OpenAPI v2 (Swagger) and OpenAPI v3 specification formats.

How does OpenAPI-MCP handle API keys?

It injects API keys into requests (via header, query, path, or cookie) based on command-line flags. Keys can be provided directly, via environment variables, or from a local `.env` file, and are never exposed to the MCP client.

Can I use a remote OpenAPI specification?

Yes, you can pass a remote URL to the `--spec` flag. The server will fetch the specification and generate tools accordingly.

What runtime is required to run OpenAPI-MCP?

OpenAPI-MCP is Dockerized. The recommended approach is to use the pre-built Docker Hub image. For local development, you can build the image from source using Go.

How do I filter which endpoints become MCP tools?

Use the command-line flags `--include-tag`, `--exclude-tag`, `--include-op`, and `--exclude-op` to include or exclude specific operations or tag groups.

Comments

Basic information

Category

AI & Agents

Transports

stdio

Author

ckanthony

More AI & Agents MCP servers

Open Multi-Agent Canvas

CopilotKit

The open-source multi-agent chat interface that lets you manage multiple agents in one dynamic conversation and add MCP servers for deep research

507

MCP Server - Remote MacOs Use

baryhuang

The only general AI agent that does NOT requires extra API key, giving you full control on your local and remote MacOs from Claude Desktop App

487

Shell and Coding agent for Claude and other mcp clients

rusiaaman

Shell and coding agent on mcp clients

666

欢迎来到 智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797

LinkedIn MCP Server

stickerdaniel

Open-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.

2.7K