eyaushev/swagger-testcase-mcp

eyaushev/swagger-testcase-mcp

от eyaushev
Автоматически генерирует тест-кейсы из Swagger/OpenAPI спецификаций. Анализирует параметры, ограничения и схемы, создавая тесты 8 категорий для ручного тестирования или импорта в TMS, ускоряя подго...

swagger-testcase-mcp

npm version License: MIT Node.js

MCP server for API testing: generates test cases, validates specs, compares versions, and creates mock data from Swagger/OpenAPI specifications.

Feed it your API spec URL — get structured, categorized test cases (positive, negative, boundary, auth, security, idempotency, pagination) ready for manual testing or import into your TMS.

Why

  • Writing test cases manually is slow. A single endpoint with 10+ parameters can require 30-50 test cases across positive, negative, boundary, and security scenarios. Multiply that by dozens of endpoints — and you're spending days on routine work instead of actual testing.
  • Negative and boundary cases get skipped. Under deadline pressure, QA focuses on happy paths. Edge cases, invalid inputs, and security checks are the first to be cut — and the first to cause production incidents.
  • Specs change faster than test docs, and internal APIs get left behind. New endpoints, renamed fields, changed constraints — keeping test cases in sync is constant overhead. Corporate APIs behind VPN or custom auth make it even harder, since most tooling doesn't support authenticated spec access.
  • Getting test cases into your TMS takes extra steps. Even if you write great test cases, formatting them for TestRail, Allure, or Postman import is tedious work that adds no value.
Инструменты были проиндексированы:
analyze_endpoint

Анализирует конкретный эндпоинт из загруженной Swagger-спецификации. Возвращает подробную информацию о параметрах, теле запроса, ответах и безопасности.

Параметры
  • auth_headerstring

    Значение заголовка Authorization, например "Bearer eyJ..." или "Basic dXNlcjpwYXNz"

  • headersobject

    Дополнительные HTTP-заголовки в виде пар «ключ-значение», например {"X-API-Key": "abc123"}

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

    HTTP-метод

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

    Путь эндпоинта, например /api/orders

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

    Источник спецификации Swagger/OpenAPI: URL (https://...) или локальный путь к файлу (/path/to/spec.json, ./spec.yaml)

clear_cache

Очищает кэшированные спецификации и/или сгенерированные тестовые примеры. Полезно, когда спецификация была обновлена и её нужно перезагрузить.

Параметры
  • targetenumобязательный

    Что очистить: спецификации, тест-кейсы или всё

compare_specs

Сравнивает две версии OpenAPI-спецификации. Обнаруживает добавленные/удалённые/изменённые эндпоинты, изменения в схемах и критические изменения.

Параметры
  • auth_headerstring

    Значение заголовка Authorization, например "Bearer eyJ..." или "Basic dXNlcjpwYXNz"

  • headersobject

    Дополнительные HTTP-заголовки в виде пар «ключ-значение», например {"X-API-Key": "abc123"}

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

    Новый источник спецификации: URL или путь к файлу

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

    Источник старой спецификации: URL или путь к файлу

export_test_cases

Экспортирует ранее сгенерированные тестовые случаи в различных форматах: markdown, json, csv, allure_csv, gherkin, postman, k6, pytest, testrail_csv (шаблон Steps), testrail_csv_text (шаблон Text).

Параметры
  • endpointstringобязательный

    Ключ конечной точки, например "POST /api/orders", или "_last_batch" для генерации последнего пакета.

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

    Формат экспорта. testrail_csv использует шаблон Steps (одна строка на шаг), testrail_csv_text использует шаблон Text (все шаги в одном поле).

  • output_pathstring

    Пользовательский путь к файлу для сохранения экспорта. Если не указан, сохраняет автоматически в рабочую директорию с сгенерированным именем файла.

fetch_swagger

Загружает и парсит спецификацию OpenAPI/Swagger. Поддерживает: - Публичные URL: https://api.example.com/swagger.json - Внутренние URL (доступные с машины пользователя/через VPN): https://internal-api.company.com/docs/swagger.json - Локальные файлы: /path/to/swagger.json, ./api-spec.yaml - Спецификации с аутентификацией: передайте auth_header для аутентификации Bearer/Basic/API-Key

Параметры
  • auth_headerstring

    Значение заголовка Authorization, например "Bearer eyJ..." или "Basic dXNlcjpwYXNz"

  • headersobject

    Дополнительные HTTP-заголовки в виде пар «ключ-значение», например {"X-API-Key": "abc123"}

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

    Источник спецификации Swagger/OpenAPI: URL (https://...) или локальный путь к файлу (/path/to/spec.json, ./spec.yaml)

generate_mock_data

Генерирует реалистичные фиктивные/примерные данные на основе схемы запроса или ответа конечной точки. Полезно для заполнения Postman, тестов или документации.

Параметры
  • auth_headerstring

    Значение заголовка Authorization, например "Bearer eyJ..." или "Basic dXNlcjpwYXNz"

  • countnumber

    Количество генерируемых mock-объектов (по умолчанию: 1)

  • formatenum

    Формат вывода (по умолчанию: json)

  • headersobject

    Дополнительные HTTP-заголовки в виде пар «ключ-значение», например {"X-API-Key": "abc123"}

  • localeenum

    Локаль для генерируемых имён/адресов (по умолчанию: en)

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

    HTTP-метод

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

    Путь эндпоинта, например /api/orders

  • response_codestring

    Код состояния ответа (по умолчанию: первый 2xx). Используется только когда target="response"

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

    Источник спецификации Swagger/OpenAPI: URL (https://...) или локальный путь к файлу (/path/to/spec.json, ./spec.yaml)

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

    Генерирует данные для тела "request" или тела "response".

  • use_examplesboolean

    Предпочитать примеры значений из спецификации (по умолчанию: true)

generate_test_cases

Генерирует QA-тест-кейсы для конкретного API-эндпоинта. Создаёт позитивные, негативные, граничные, авторизационные, security, идемпотентности, пагинации и бизнес-логики тест-кейсы на основе OpenAPI-спецификации.

Параметры
  • auth_headerstring

    Значение заголовка Authorization, например "Bearer eyJ..." или "Basic dXNlcjpwYXNz"

  • configobject

    Параметры конфигурации генерации.

  • headersobject

    Дополнительные HTTP-заголовки в виде пар «ключ-значение», например {"X-API-Key": "abc123"}

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

    HTTP-метод

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

    Путь эндпоинта, например /api/orders

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

    Источник спецификации Swagger/OpenAPI: URL (https://...) или локальный путь к файлу (/path/to/spec.json, ./spec.yaml)

generate_test_cases_batch

Генерирует QA тест-кейсы для нескольких эндпоинтов за один раз. Опционально фильтрует по тегу, методам или префиксу пути.

Параметры
  • auth_headerstring

    Значение заголовка Authorization, например "Bearer eyJ..." или "Basic dXNlcjpwYXNz"

  • configobject

    Параметры конфигурации генерации.

  • headersobject

    Дополнительные HTTP-заголовки в виде пар «ключ-значение», например {"X-API-Key": "abc123"}

  • methodsstring[]

    Фильтрует по HTTP-методам, например ['POST', 'PUT'] (необязательно).

  • path_prefixstring

    Фильтрует по префиксу пути, например '/api/v2' (необязательно).

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

    Источник спецификации Swagger/OpenAPI: URL (https://...) или локальный путь к файлу (/path/to/spec.json, ./spec.yaml)

  • tagstring

    Фильтрует эндпоинты по тегу (необязательно)

suggest_missing_tests

Анализирует тестовое покрытие для сгенерированных тестов. Показывает, какие коды ответов, параметры и граничные условия покрыты или отсутствуют. Дает приоритетные предложения по дополнительным тестам.

Параметры
  • auth_headerstring

    Значение заголовка Authorization, например "Bearer eyJ..." или "Basic dXNlcjpwYXNz"

  • endpointstring

    Конкретный endpoint, например "POST /api/orders". Опустите его для полного анализа спецификации.

  • headersobject

    Дополнительные HTTP-заголовки в виде пар «ключ-значение», например {"X-API-Key": "abc123"}

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

    Источник спецификации Swagger/OpenAPI: URL (https://...) или локальный путь к файлу (/path/to/spec.json, ./spec.yaml)

validate_spec

Проверяет OpenAPI-спецификацию на качество и полноту. Ищет отсутствующие описания, бесхозные схемы, проблемы с именованием, пропущенные ответы об ошибках и другое. Возвращает оценку качества (0-100).

Параметры
  • auth_headerstring

    Значение заголовка Authorization, например "Bearer eyJ..." или "Basic dXNlcjpwYXNz"

  • headersobject

    Дополнительные HTTP-заголовки в виде пар «ключ-значение», например {"X-API-Key": "abc123"}

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

    Источник спецификации Swagger/OpenAPI: URL (https://...) или локальный путь к файлу (/path/to/spec.json, ./spec.yaml)

1.0.0основная

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

Любой клиент

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

{
  "mcpServers": {
    "eyaushev-swagger-testcase-mcp-0ja4ug5sac": {
      "command": "npx",
      "args": [
        "-y",
        "swagger-testcase-mcp"
      ]
    }
  }
}
CursorCursor

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

{
  "mcpServers": {
    "eyaushev-swagger-testcase-mcp-0ja4ug5sac": {
      "command": "npx",
      "args": [
        "-y",
        "swagger-testcase-mcp"
      ]
    }
  }
}
VS Code

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

{
  "servers": {
    "eyaushev-swagger-testcase-mcp-0ja4ug5sac": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "swagger-testcase-mcp"
      ]
    }
  }
}

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

code --add-mcp "{\"name\":\"eyaushev-swagger-testcase-mcp-0ja4ug5sac\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"swagger-testcase-mcp\"]}"
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": {
    "eyaushev-swagger-testcase-mcp-0ja4ug5sac": {
      "command": "npx",
      "args": [
        "-y",
        "swagger-testcase-mcp"
      ]
    }
  }
}
Claude CodeClaude Code

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

claude mcp add eyaushev-swagger-testcase-mcp-0ja4ug5sac -- npx -y swagger-testcase-mcp

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

claude mcp add-json eyaushev-swagger-testcase-mcp-0ja4ug5sac "{\"command\":\"npx\",\"args\":[\"-y\",\"swagger-testcase-mcp\"]}"
CodexCodex

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

codex mcp add eyaushev-swagger-testcase-mcp-0ja4ug5sac -- npx -y swagger-testcase-mcp

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

[mcp_servers.eyaushev-swagger-testcase-mcp-0ja4ug5sac]
command = "npx"
args = ["-y", "swagger-testcase-mcp"]
PerplexityPerplexity

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

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

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

WindsurfWindsurf

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

{
  "mcpServers": {
    "eyaushev-swagger-testcase-mcp-0ja4ug5sac": {
      "command": "npx",
      "args": [
        "-y",
        "swagger-testcase-mcp"
      ]
    }
  }
}
ClineCline

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

{
  "mcpServers": {
    "eyaushev-swagger-testcase-mcp-0ja4ug5sac": {
      "command": "npx",
      "args": [
        "-y",
        "swagger-testcase-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

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

mcpServers:
  - name: eyaushev-swagger-testcase-mcp-0ja4ug5sac
    command: npx
    args:
      - "-y"
      - "swagger-testcase-mcp"
Zed

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

{
  "context_servers": {
    "eyaushev-swagger-testcase-mcp-0ja4ug5sac": {
      "command": "npx",
      "args": [
        "-y",
        "swagger-testcase-mcp"
      ]
    }
  }
}

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

cocaxcode/api-testing-mcp

cocaxcode/api-testing-mcp

от cocaxcode

Полноценный MCP сервер для тестирования API: 42 инструмента без настройки. HTTP-запросы с проверками, цепочки и импорт OpenAPI. Также генерация моков, нагрузочное тестирование и сравнение ответов, всё из диалога. Для разработчиков и тестировщиков.

TypeScript⭐ 11
hijaz/postmancer

hijaz/postmancer

от hijaz

Postmancer — MCP сервер для тестирования REST API, аналог Postman для ИИ. Отправляет HTTP запросы, управляет коллекциями, подставляет переменные окружения, поддерживает аутентификацию (Basic, Bearer, API Key, OAuth2). Полезен разработчикам для интеграции AI в тестирование.

TypeScript⭐ 29
hungthai1401/bruno-mcp

hungthai1401/bruno-mcp

от hungthai1401

Запускает Bruno-коллекции, возвращает детальный отчёт: статус, упавшие тесты, тайминги. Поддерживает environment-файлы и переменные окружения.

JavaScript⭐ 44
browserstack/mcp-server

browserstack/mcp-server

от browserstack

MCP сервер BrowserStack для тестирования через AI. Управляйте тест-кейсами, запускайте ручные и автотесты, отлаживайте и исправляйте код на естественном языке. Работает в Cursor и Claude.

TypeScript⭐ 155
ronantakizawa/a11ymcp

ronantakizawa/a11ymcp

от ronantakizawa

MCP сервер с Axe-core и Puppeteer для тестирования веб-доступности: проверяет URL и HTML-фрагменты на WCAG (2.0-2.2), оценивает цветовой контраст, ARIA-атрибуты и ориентацию. Полезен разработчикам ...

JavaScript⭐ 93
Hypersequent/qasphere-mcp

Hypersequent/qasphere-mcp

от hypersequent

MCP сервер для интеграции с QA Sphere, системой управления тестированием. Он позволяет AI-ассистентам искать, анализировать и обсуждать тест-кейсы прямо в IDE. Полезен разработчикам и QA-инженерам.

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

Лука Никитин