OpenAPI MCP Server

A Quick Way to Create an MCP Server with StreamableHTTP transport implementation from OpenAPI docs.

Overview

This server provides a standardized way to interact with model services through a RESTful API interface. It implements the Model Context Protocol (MCP) and is designed to be easily configurable. Simply set up your .env file, and the server is ready to run.

It implements the Model Context Protocol (MCP) specification and supports OpenAPI documentation.

Features

OpenAPI 3.0.0 compliant API documentation
Model service API documentation retrieval
Model service invocation with parameter handling
TypeScript implementation for type safety

Prerequisites

Node.js (v20 or higher)
npm (v6 or higher)

Quick Start

Clone the repository:
git clone https://github.com/oneWalker/openapi-mcp-server.git cd openapi-mcp-server
Install dependencies:
npm install
Configure your environment: Create a .env file in the project root and add your configuration. See the Configuration section for details.
Run the server:
npm run build npm run start

Installation

Clone the repository
Install dependencies:

npm install

Development

Building the Project

npm run build

Running in Development Mode

npm run watch

Starting the Server

npm  run start

Configuration

Create a .env file in the root of the project to configure the server.

# The base URL for the original API server
BASE_SERVER_URL= https://api.example.com

# The path to the OpenAPI specification file (can be a local file or a URL).
OPENAPI_PATH=./example.yaml or ./example.json # example.yaml is just for demo

# The port for the MCP server to run on
PORT=8000

API Endpoints

Get Model Service API Documentation

GET /api/model/services/{ID}

Retrieves the API documentation for a specific model service.

Parameters:

ID (path, required): Model service ID
authorization (header, required): Bearer token for authentication

Call Model Service

POST /api/model/services/

Invokes a specific model service with provided parameters.

Parameters:

id (path, required): Model service ID

Request Body:

{
  "id": "123"
}

Project Structure

openapi-mcp-server/
├── src/              # Source code
├── build/            # Compiled JavaScript files
├── example.yaml # OpenAPI specification
├── package.json      # Project configuration
└── tsconfig.json     # TypeScript configuration

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Please see the CONTRIBUTING.md file for details on our code of conduct, and the process for submitting pull requests to us.

Reporting Issues

We use GitHub Issues to track public bugs. Report a bug by opening a new issue; it's that easy!

Dependencies

openapi-mcp-generator: OpenAPI specification generator
- Note: This project requires a pending fix from the openapi-mcp-generator library. See this pull request.
@modelcontextprotocol/sdk: MCP SDK for protocol implementation
express: Web framework
dotenv: Environment variable management
got: HTTP client

Development Dependencies

TypeScript
@types/express
@types/node

License

MIT License - See LICENSE file for details

Authors

Brian,Kun Liu

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A server that implements the Model Context Protocol (MCP) with StreamableHTTP transport, enabling standardized interaction with model services through a RESTful API interface.

Related MCP Servers

openrpc-mpc-server
shanejonas
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides JSON-RPC functionality through OpenRPC.
Last updated -
2
7
33
JavaScript
Apache 2.0
MCP Server
la-rebelion
-
security
A
license
-
quality
MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
Last updated -
4
3
TypeScript
MIT License
MCP Server
agentico-dev
-
security
A
license
-
quality
MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
Last updated -
13
2
TypeScript
MIT License
MCP-OpenAPI
rmasters
-
security
A
license
-
quality
An MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.
Last updated -
2
Python
MIT License

View all related MCP servers

OpenAPI MCP Server