Package Exports

relay-mcp
relay-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (relay-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Relay

Universal OpenAPI ➜ MCP relay server with enterprise authentication.

What is Relay?

Relay converts any OpenAPI/Swagger specification into AI-callable MCP tools. It acts as a bridge between AI assistants and REST APIs, automatically generating tools from API documentation and executing real HTTP requests.

Main Function: Transform any REST API into MCP tools that AI assistants can use directly.

Installation

npm install relay-mcp

Basic Usage

Install and build:

npm install
npm run build

Configure (create .env file):

SWAGGER_SOURCE=url
SWAGGER_URL=https://petstore.swagger.io/v2/swagger.json
AUTH_TYPE=none

Run the server:

npm start

Add to MCP client (e.g., Claude Desktop):

{
  "mcpServers": {
    "relay": {
      "command": "node",
      "args": ["/path/to/relay/dist/index.js"],
      "env": {
        "SWAGGER_SOURCE": "url",
        "SWAGGER_URL": "https://petstore.swagger.io/v2/swagger.json",
        "AUTH_TYPE": "none"
      }
    }
  }
}

Features

Dynamic tool generation from any OpenAPI/Swagger spec
Real HTTP execution with interceptors and structured logging
Auth: API Key (header/query), Bearer, Basic
OpenAPI 2.0 and 3.x support

Documentation

Getting started: docs/QUICKSTART.md
Changelog: CHANGELOG.md

License

MIT

relay-mcp