Advertise
MCP.so
Sign In

OpenAPI → MCP Server

@nihal1294

Repository

Basic information

Category

Other

License

Apache-2.0 license

Transports

stdio

Author

nihal1294

About OpenAPI → MCP Server

A Python CLI tool that generates a basic Node.js/TypeScript MCP server from an OpenAPI v3 spec (JSON/YAML), mapping each operation to an MCP tool.

#typescript#mcp#python3#openapi3#mcp-server#openapi-to-mcp

OpenAPI → MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

OpenAPI → MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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?

A Python CLI tool that generates a Node.js/TypeScript Model Context Protocol (MCP) server from an OpenAPI v3 specification (JSON or YAML). Each API operation becomes an MCP tool, and the generated server translates MCP calls into HTTP requests to the target API.

How to use OpenAPI → MCP Server?

Install dependencies via poetry install --no-dev, then run the generate command with --openapi-json pointing to the spec file or URL. After generation, set the .env file with the target API base URL (and optional auth header), then npm install, npm run build, and npm start inside the output directory. Use the test-server command or the MCP Inspector to test the server.

Key features of OpenAPI → MCP Server

  • Parses OpenAPI v3 JSON or YAML from local files or URLs.
  • Maps each API operation (GET, POST, PUT, DELETE, PATCH) to an MCP tool.
  • Generates a runnable Node.js/TypeScript MCP server project.
  • Supports stdio and SSE transport with configurable port.
  • Includes basic error mapping from HTTP status codes to MCP errors.
  • Handles simple local $refs, cycles, and basic type schemas.

Use cases of OpenAPI → MCP Server

  • Quickly turn any REST API with an OpenAPI spec into an MCP-compatible server.
  • Enable AI assistants to call existing APIs via MCP without manual tool definitions.
  • Prototype MCP integrations for legacy or third-party HTTP APIs.

Frequently asked questions

1

What are the prerequisites to run the generator?

Python 3.12+, Poetry, and Node.js 20+ for the generated server. The MCP SDK (1.5.0) is installed automatically via Poetry.

2

What transport options does the generated server support?

The generated server can use stdio (default) or SSE. For SSE, specify `--transport sse` and optionally `--port` (default 8080).

3

How do I provide authentication for the target API?

Set the `TARGET_API_AUTH_HEADER` environment variable in the `.env` file (e.g., `Authorization: Bearer token` or `X-API-Key: key`).

4

Where is the generated server code placed?

By default in `./mcp-server`, but you can change this with `--output-dir`. The generated directory includes a complete Node.js/TypeScript project with its own README.

5

Can I test the generated server without a full client?

Yes, the tool includes a `test-server` command to send `ListTools` and `CallTool` requests via stdio or SSE. Alternatively, use the MCP Inspector for a graphical interface.

Comments

More Other MCP servers

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Advertise