Relay

通用OpenAPI ➜ 配备企业认证的MCP中继服务器。

Relay 是什么？

Relay 将任何 OpenAPI/Swagger 规范转换为可由AI调用的MCP工具。它充当AI助手与REST API之间的桥梁，自动从API文档生成工具并执行实际的HTTP请求。

主要功能：将任何REST API转换为可以直接供AI助手使用的MCP工具。

安装

npm install relay-mcp

基本使用

1. 安装和构建：

npm install
npm run build

2. 配置（创建.env文件）：

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

3. 运行服务器：

npm start

4. 添加到MCP客户端（例如，Claude Desktop用于stdio）：

{
  "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",
        "TRANSPORT": "stdio"
      }
    }
  }
}

或者作为独立服务器运行，使用SSE/HTTP：

# 对于SSE传输
TRANSPORT=sse TRANSPORT_PORT=3000 npm start

# 对于HTTP传输
TRANSPORT=http TRANSPORT_PORT=3000 npm start

然后配置您的MCP客户端连接到http://localhost:3000/mcp。

功能

• 从任何OpenAPI/Swagger规范动态生成工具
• 使用拦截器和结构化日志执行实际HTTP请求
• 认证：API密钥（头部/查询）、Bearer、Basic
• 支持OpenAPI 2.0 和 3.x
• 多种传输模式：stdio、SSE（服务器发送事件）、HTTP

文档

• 📚 文档中心 - 完整文档索引
• 🚀 快速入门指南 - 快速启动
• 🔧 设置说明 - 详细配置
• 📋 变更记录 - 版本历史和更新

链接

• NPM 包：relay-mcp
• GitHub 仓库：Algovate/relay-mcp
• 文档网站：algovate.github.io/relay-mcp

许可证

MIT