open-api-mcp

Name: open-api-mcp
Author: nexpando-com

@nexpando-com

代码仓库

关于 open-api-mcp

Generate a MCP server based on OpenAPI specifications

基本信息

分类

开发工具

许可证

MIT

运行时

node

传输方式

stdio

发布者

nexpando-com

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "open-api-mcp": {
      "command": "bun",
      "args": [
        "dev"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is open-api-mcp?

open-api-mcp is a command-line tool that generates an MCP (Model Context Protocol) server from OpenAPI specifications. It simplifies creating API clients by leveraging OpenAPI schemas and generating strongly-typed clients using Zod.

How to use open-api-mcp?

Clone the repository, install dependencies with bun install, prepare an OpenAPI specification (JSON or YAML), copy .env.template to .env, then start the server with bun dev or ./cli.sh open-api.json. For Docker, add the spec to a specs directory and run docker-compose up with appropriate environment variables.

Key features of open-api-mcp

Generate MCP servers from OpenAPI specifications
Automatically create Zod-based API clients for type-safe interactions
Supports both JSON and YAML OpenAPI specification formats
Easily configurable via environment variables or Docker Compose

Use cases of open-api-mcp

Quickly create an MCP server for any REST API with an OpenAPI spec
Generate type-safe API clients for integration in AI applications
Deploy API gateway MCP servers in containerized environments

FAQ from open-api-mcp

How do I customize authentication?

Override the get-axios.ts file with your own authentication logic. By default, it uses a Bearer token from the API_KEY environment variable. With Docker, mount a custom version of get-axios.ts as a volume.

What transport types are supported?

Supported transport types are httpStream, sse, and stdio, configurable via the MCP_TRANSPORT_TYPE environment variable.

How do I run open-api-mcp with Docker?

Create a specs directory with your OpenAPI file, define a docker-compose.yml with the nexpando/open-api-mcp image, mount the specs directory, and set environment variables (OPEN_API_FILE, API_URL, optionally API_KEY, MCP_NAME, MCP_VERSION, MCP_TRANSPORT_TYPE). Then run docker-compose up.

What are the runtime dependencies?

The project uses the Bun runtime (install with bun install). A Docker image is also available for containerized deployment.

Where should I place the OpenAPI specification file?

Place it in the specs directory (e.g., specs/open-api.json or specs/open-api.yml) and set the OPEN_API_FILE environment variable to point to it.

开发工具分类下的更多 MCP 服务器

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K

test

harlanc

A simple,high performance and secure live media server in pure Rust (RTMP[cluster]/RTSP/WebRTC[whip/whep]/HTTP-FLV/HLS).🦀

2.3K

Golf

golf-mcp

Production-Ready MCP Server Framework • Build, deploy & scale secure AI agent infrastructure • Includes Auth, Observability, Debugger, Telemetry & Runtime • Run real-world MCPs powering AI Agents

834