Каталог MCP
mroops0111/openapi-mcp-gateway

mroops0111/openapi-mcp-gateway

Name: mroops0111/openapi-mcp-gateway
Availability: InStock
Author: mroops0111

MCP сервер для подключения OpenAPI (Swagger) спецификаций и FastAPI приложений. Поддерживает несколько API в одном процессе, каждый со своей аутентификацией (bearer, OAuth2, API key) и транспортами (HTTP, SSE, stdio). Полезен разработчикам AI-агентов и интеграций.

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

OpenAPI MCP Gateway

Mount any OpenAPI (Swagger) spec as a Model Context Protocol (MCP) server, or expose an existing FastAPI app the same way. Multiple APIs in one process, each with its own mount path and auth.

uvx openapi-mcp-gateway --spec https://petstore3.swagger.io/api/v3/openapi.json
# Server live at http://127.0.0.1:8000/api/mcp

Multi-Spec, Multi-Auth. Mount GitHub, an OAuth2 SaaS, and your internal API side by side, each with its own auth and token namespace.
Spec-Compliant Authorization. The gateway runs its own OAuth server and mints audience-bound upstream tokens, so the MCP client's credential is never replayed against a third party.
Tool Shaping. Rename ugly operationIds, hide knobs the model should never touch, and rewrite requests and responses with JSONata, all in YAML with no fork required.
Dynamic Exposure. Front a 1,200-operation spec with three list → get → call meta-tools, so connecting to it does not spend the LLM's whole context window on tool schemas.
Resources, Not Just Tools. Eligible read-only GETs register as MCP resources instead, addressable by URI and surfaced by the client rather than guessed at by the model.
FastAPI-Native. Decorate routes with @mcp_tool to expose them in-process over ASGI, no extra hop and no second spec to maintain.

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить mroops0111/openapi-mcp-gateway:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "mroops0111-openapi-mcp-gateway-69rd0hnjpk": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/abs/path/to/your/project",
        "openapi-mcp-gateway",
        "--spec",
        "/abs/path/to/openapi.json",
        "--transport",
        "stdio"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "mroops0111-openapi-mcp-gateway-69rd0hnjpk": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/abs/path/to/your/project",
        "openapi-mcp-gateway",
        "--spec",
        "/abs/path/to/openapi.json",
        "--transport",
        "stdio"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "mroops0111-openapi-mcp-gateway-69rd0hnjpk": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/abs/path/to/your/project",
        "openapi-mcp-gateway",
        "--spec",
        "/abs/path/to/openapi.json",
        "--transport",
        "stdio"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"mroops0111-openapi-mcp-gateway-69rd0hnjpk\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"run\",\"--project\",\"/abs/path/to/your/project\",\"openapi-mcp-gateway\",\"--spec\",\"/abs/path/to/openapi.json\",\"--transport\",\"stdio\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "mroops0111-openapi-mcp-gateway-69rd0hnjpk": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/abs/path/to/your/project",
        "openapi-mcp-gateway",
        "--spec",
        "/abs/path/to/openapi.json",
        "--transport",
        "stdio"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add mroops0111-openapi-mcp-gateway-69rd0hnjpk -- uv run --project /abs/path/to/your/project openapi-mcp-gateway --spec /abs/path/to/openapi.json --transport stdio

Либо через JSON-конфиг:

claude mcp add-json mroops0111-openapi-mcp-gateway-69rd0hnjpk "{\"command\":\"uv\",\"args\":[\"run\",\"--project\",\"/abs/path/to/your/project\",\"openapi-mcp-gateway\",\"--spec\",\"/abs/path/to/openapi.json\",\"--transport\",\"stdio\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add mroops0111-openapi-mcp-gateway-69rd0hnjpk -- uv run --project /abs/path/to/your/project openapi-mcp-gateway --spec /abs/path/to/openapi.json --transport stdio

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.mroops0111-openapi-mcp-gateway-69rd0hnjpk]
command = "uv"
args = ["run", "--project", "/abs/path/to/your/project", "openapi-mcp-gateway", "--spec", "/abs/path/to/openapi.json", "--transport", "stdio"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите mroops0111/openapi-mcp-gateway, а в поле команды запуска — строку ниже:

uv run --project /abs/path/to/your/project openapi-mcp-gateway --spec /abs/path/to/openapi.json --transport stdio

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mroops0111-openapi-mcp-gateway-69rd0hnjpk": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/abs/path/to/your/project",
        "openapi-mcp-gateway",
        "--spec",
        "/abs/path/to/openapi.json",
        "--transport",
        "stdio"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "mroops0111-openapi-mcp-gateway-69rd0hnjpk": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/abs/path/to/your/project",
        "openapi-mcp-gateway",
        "--spec",
        "/abs/path/to/openapi.json",
        "--transport",
        "stdio"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например mroops0111-openapi-mcp-gateway-69rd0hnjpk.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: mroops0111-openapi-mcp-gateway-69rd0hnjpk
    command: uv
    args:
      - "run"
      - "--project"
      - "/abs/path/to/your/project"
      - "openapi-mcp-gateway"
      - "--spec"
      - "/abs/path/to/openapi.json"
      - "--transport"
      - "stdio"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "mroops0111-openapi-mcp-gateway-69rd0hnjpk": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/abs/path/to/your/project",
        "openapi-mcp-gateway",
        "--spec",
        "/abs/path/to/openapi.json",
        "--transport",
        "stdio"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uv",
  "args": [
    "run",
    "--project",
    "/abs/path/to/your/project",
    "openapi-mcp-gateway",
    "--spec",
    "/abs/path/to/openapi.json",
    "--transport",
    "stdio"
  ]
}