saurav61091/mcp-openapi

saurav61091/mcp-openapi

от saurav61091
Превращает любую OpenAPI 3.x спецификацию в MCP-инструменты для Claude - одной строкой в конфиге. Claude вызывает эндпоинты через естественный язык, инструменты обновляются автоматически.

mcp-openapi

npm version CI License: MIT Node.js MCP

Turn any OpenAPI spec into MCP tools for Claude — zero config, instant API access.

Point mcp-openapi-runner at any OpenAPI 3.x spec and Claude can call every endpoint through natural language. No custom integration code. No manual tool definitions. One line of config.

Why mcp-openapi?

Without mcp-openapi With mcp-openapi
Write custom MCP server per API One config line per API
Define tool schemas manually Auto-generated from OpenAPI spec
Handle auth, params, body yourself Built-in auth + parameter handling
Maintain code as API evolves Spec changes = tools update automatically

Quick start

Add to your Claude Desktop / Claude Code / Cursor / Cline MCP config:

{
  "mcpServers": {
    "petstore": {
      "command": "npx",
      "args": ["-y", "mcp-openapi-runner", "--spec", "https://petstore3.swagger.io/api/v3/openapi.json"]
    }
  }
}

That's it. Claude can now discover and call every endpoint in that API.

Example conversation

Инструменты были проиндексированы:
call_endpoint

Вызывает эндпоинт в Swagger Petstore - OpenAPI 3.0. Сначала использует list_endpoints, чтобы узнать доступные operationIds и их обязательные параметры.

Параметры
  • bodyany

    Тело запроса для POST/PUT/PATCH-запросов (объект или строка)

  • operationIdstringобязательный

    operationId из list_endpoints, например 'getPetById' или 'createUser'

  • parametersobject

    Параметры path, query и header в виде пар ключ-значение

list_endpoints

Выводит список всех доступных эндпоинтов в Swagger Petstore - OpenAPI 3.0. Вызывается первым, чтобы узнать, какие операции доступны, и получить их operationIds.

Параметры

Без параметров.

1.1.0основная
1.0.1
1.0.0

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

Любой клиент

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

{
  "mcpServers": {
    "saurav61091-mcp-openapi-n81txfmcdx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-runner",
        "--spec",
        "https://petstore3.swagger.io/api/v3/openapi.json"
      ]
    }
  }
}
CursorCursor

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

{
  "mcpServers": {
    "saurav61091-mcp-openapi-n81txfmcdx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-runner",
        "--spec",
        "https://petstore3.swagger.io/api/v3/openapi.json"
      ]
    }
  }
}
VS Code

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

{
  "servers": {
    "saurav61091-mcp-openapi-n81txfmcdx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-runner",
        "--spec",
        "https://petstore3.swagger.io/api/v3/openapi.json"
      ]
    }
  }
}

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

code --add-mcp "{\"name\":\"saurav61091-mcp-openapi-n81txfmcdx\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"mcp-openapi-runner\",\"--spec\",\"https://petstore3.swagger.io/api/v3/openapi.json\"]}"
ClaudeClaude 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": {
    "saurav61091-mcp-openapi-n81txfmcdx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-runner",
        "--spec",
        "https://petstore3.swagger.io/api/v3/openapi.json"
      ]
    }
  }
}
Claude CodeClaude Code

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

claude mcp add saurav61091-mcp-openapi-n81txfmcdx -- npx -y mcp-openapi-runner --spec https://petstore3.swagger.io/api/v3/openapi.json

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

claude mcp add-json saurav61091-mcp-openapi-n81txfmcdx "{\"command\":\"npx\",\"args\":[\"-y\",\"mcp-openapi-runner\",\"--spec\",\"https://petstore3.swagger.io/api/v3/openapi.json\"]}"
CodexCodex

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

codex mcp add saurav61091-mcp-openapi-n81txfmcdx -- npx -y mcp-openapi-runner --spec https://petstore3.swagger.io/api/v3/openapi.json

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

[mcp_servers.saurav61091-mcp-openapi-n81txfmcdx]
command = "npx"
args = ["-y", "mcp-openapi-runner", "--spec", "https://petstore3.swagger.io/api/v3/openapi.json"]
PerplexityPerplexity

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

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите saurav61091/mcp-openapi, а в поле команды запуска — строку ниже:
npx -y mcp-openapi-runner --spec https://petstore3.swagger.io/api/v3/openapi.json

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

WindsurfWindsurf

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

{
  "mcpServers": {
    "saurav61091-mcp-openapi-n81txfmcdx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-runner",
        "--spec",
        "https://petstore3.swagger.io/api/v3/openapi.json"
      ]
    }
  }
}
ClineCline

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

{
  "mcpServers": {
    "saurav61091-mcp-openapi-n81txfmcdx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-runner",
        "--spec",
        "https://petstore3.swagger.io/api/v3/openapi.json"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

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

mcpServers:
  - name: saurav61091-mcp-openapi-n81txfmcdx
    command: npx
    args:
      - "-y"
      - "mcp-openapi-runner"
      - "--spec"
      - "https://petstore3.swagger.io/api/v3/openapi.json"
Zed

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

{
  "context_servers": {
    "saurav61091-mcp-openapi-n81txfmcdx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-runner",
        "--spec",
        "https://petstore3.swagger.io/api/v3/openapi.json"
      ]
    }
  }
}

Похожие MCP-сервера

ycs77/apifable

ycs77/apifable

от ycs77

apifable - MCP-сервер для AI-агентов: ищет эндпоинты, изучает OpenAPI-спецификацию и генерирует TypeScript типы. Всё, чтобы AI писал точный код интеграции в TypeScript-проекты.

TypeScript⭐ 10
nk3750/jitapi

nk3750/jitapi

от nk3750

JitAPI - MCP сервер для интеграции Claude с любыми API через OpenAPI. Семантический поиск и граф зависимостей находят нужные эндпоинты, экономя контекст. Разработчики могут выполнять сложные сценар...

Python⭐ 7
mroops0111/openapi-mcp-gateway

mroops0111/openapi-mcp-gateway

от mroops0111

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

Python⭐ 7
anaisbetts/mcp-installer

anaisbetts/mcp-installer

от anaisbetts

Ставит любые MCP-серверы из npm и PyPi одной командой: скачивает, прописывает в конфиг, подключает. Понимает локальные пути и переменные окружения.

JavaScript⭐ 1532
ReAPI-com/mcp-openapi

ReAPI-com/mcp-openapi

официальный

от reapi-com

MCP сервер для загрузки OpenAPI спецификаций и их интеграции с LLM в IDE. Он помогает разработчикам находить операции, схемы и получать контекст для генерации кода и работы с API.

TypeScript⭐ 90
kadykov/mcp-openapi-schema-explorer

kadykov/mcp-openapi-schema-explorer

от kadykov

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

TypeScript⭐ 76
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин