Для чего этот сервер?

Этот MCP-сервер помогает ИИ-агентам работать с большими OpenAPI и Swagger спецификациями, не загружая весь документ целиком. Он отдаёт только нужные части через ресурсные шаблоны, экономя токены и ускоряя анализ API. Сервер загружает спецификации из файлов или по ссылке, а Swagger 2.0 конвертирует автоматически. Он полезен разработчикам, которые хотят, чтобы их ИИ понимал структуру API без перегрузки контекста.

Каталог MCP
kadykov/mcp-openapi-schema-explorer

kadykov/mcp-openapi-schema-explorer

от kadykov

MCP-сервер для токен-эффективного исследования OpenAPI и Swagger спецификаций. Resource Templates дают клиентам (Claude, Cline) доступ к отдельным частям API без загрузки всего файла в контекст. По...

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

README

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

Версии

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

MCP OpenAPI Schema Explorer

An MCP (Model Context Protocol) server that provides token-efficient access to OpenAPI (v3.0) and Swagger (v2.0) specifications via MCP Resource Templates.

Project Goal

The primary goal of this project is to allow MCP clients (like Cline or Claude Desktop) to explore the structure and details of large OpenAPI specifications without needing to load the entire file into an LLM's context window. It achieves this by exposing parts of the specification through MCP Resource Templates, which provide parameterized access patterns for read-only data exploration.

This server supports loading specifications from both local file paths and remote HTTP/HTTPS URLs. Swagger v2.0 specifications are automatically converted to OpenAPI v3.0 upon loading.

Note: This server provides resource templates (not pre-enumerated resources). MCP clients access these templates through the resources/templates/list protocol method. For more information about resource templates, see the MCP Resource Templates documentation.

Часто задаваемые вопросы

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

`1.3.5`основная	13.10.2026
`1.3.4`	15.06.2026
`1.3.3`	15.01.2026
`1.3.2`	26.11.2025
`1.3.1`	20.11.2025
`1.3.0`	12.08.2025
`1.2.1`	13.04.2025
`1.1.0`	13.04.2025
`1.0.2`	13.04.2025
`1.0.1`	12.04.2025
`1.0.0`	12.04.2025

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

Любой клиент

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

{
  "mcpServers": {
    "kadykov-mcp-openapi-schema-explorer-61y6st0678": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-schema-explorer@latest",
        "<path-or-url-to-spec>",
        "--output-format",
        "yaml"
      ],
      "env": {}
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "kadykov-mcp-openapi-schema-explorer-61y6st0678": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-schema-explorer@latest",
        "<path-or-url-to-spec>",
        "--output-format",
        "yaml"
      ],
      "env": {}
    }
  }
}

VS Code

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

{
  "servers": {
    "kadykov-mcp-openapi-schema-explorer-61y6st0678": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-schema-explorer@latest",
        "<path-or-url-to-spec>",
        "--output-format",
        "yaml"
      ],
      "env": {}
    }
  }
}

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

code --add-mcp "{\"name\":\"kadykov-mcp-openapi-schema-explorer-61y6st0678\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"mcp-openapi-schema-explorer@latest\",\"<path-or-url-to-spec>\",\"--output-format\",\"yaml\"],\"env\":{}}"

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": {
    "kadykov-mcp-openapi-schema-explorer-61y6st0678": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-schema-explorer@latest",
        "<path-or-url-to-spec>",
        "--output-format",
        "yaml"
      ],
      "env": {}
    }
  }
}

Claude Code

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

claude mcp add kadykov-mcp-openapi-schema-explorer-61y6st0678 -- npx -y mcp-openapi-schema-explorer@latest <path-or-url-to-spec> --output-format yaml

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

claude mcp add-json kadykov-mcp-openapi-schema-explorer-61y6st0678 "{\"command\":\"npx\",\"args\":[\"-y\",\"mcp-openapi-schema-explorer@latest\",\"<path-or-url-to-spec>\",\"--output-format\",\"yaml\"],\"env\":{}}"

Codex

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

codex mcp add kadykov-mcp-openapi-schema-explorer-61y6st0678 -- npx -y mcp-openapi-schema-explorer@latest <path-or-url-to-spec> --output-format yaml

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

[mcp_servers.kadykov-mcp-openapi-schema-explorer-61y6st0678]
command = "npx"
args = ["-y", "mcp-openapi-schema-explorer@latest", "<path-or-url-to-spec>", "--output-format", "yaml"]

Perplexity

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

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

npx -y mcp-openapi-schema-explorer@latest <path-or-url-to-spec> --output-format yaml

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

Windsurf

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

{
  "mcpServers": {
    "kadykov-mcp-openapi-schema-explorer-61y6st0678": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-schema-explorer@latest",
        "<path-or-url-to-spec>",
        "--output-format",
        "yaml"
      ],
      "env": {}
    }
  }
}

Cline

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

{
  "mcpServers": {
    "kadykov-mcp-openapi-schema-explorer-61y6st0678": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-schema-explorer@latest",
        "<path-or-url-to-spec>",
        "--output-format",
        "yaml"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например kadykov-mcp-openapi-schema-explorer-61y6st0678.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: kadykov-mcp-openapi-schema-explorer-61y6st0678
    command: npx
    args:
      - "-y"
      - "mcp-openapi-schema-explorer@latest"
      - "<path-or-url-to-spec>"
      - "--output-format"
      - "yaml"

Zed

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

{
  "context_servers": {
    "kadykov-mcp-openapi-schema-explorer-61y6st0678": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-schema-explorer@latest",
        "<path-or-url-to-spec>",
        "--output-format",
        "yaml"
      ],
      "env": {}
    }
  }
}

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

{
  "command": "npx",
  "args": [
    "-y",
    "mcp-openapi-schema-explorer@latest",
    "<path-or-url-to-spec>",
    "--output-format",
    "yaml"
  ],
  "env": {}
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx