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 header value, e.g. "Bearer eyJ..." or "Basic dXNlcjpwYXNz"

  • headersobject

    Additional HTTP headers as key-value pairs, e.g. {"X-API-Key": "abc123"}

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

    HTTP method

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

    Endpoint path, e.g. /api/orders

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

    Swagger/OpenAPI spec source: URL (https://...) or local file path (/path/to/spec.json, ./spec.yaml)

clear_cache

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

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

    What to clear: specs, test_cases, or all

compare_specs

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

Параметры
  • auth_headerstring

    Authorization header value, e.g. "Bearer eyJ..." or "Basic dXNlcjpwYXNz"

  • headersobject

    Additional HTTP headers as key-value pairs, e.g. {"X-API-Key": "abc123"}

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

    New spec source: URL or file path

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

    Old spec source: URL or file path

export_test_cases

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

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

    Endpoint key like "POST /api/orders", or "_last_batch" for the last batch generation

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

    Export format. testrail_csv uses Steps template (one row per step), testrail_csv_text uses Text template (all steps in one field)

  • output_pathstring

    Custom file path to save the export. If omitted, saves automatically to the working directory with a generated filename.

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 header value, e.g. "Bearer eyJ..." or "Basic dXNlcjpwYXNz"

  • headersobject

    Additional HTTP headers as key-value pairs, e.g. {"X-API-Key": "abc123"}

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

    Swagger/OpenAPI spec source: URL (https://...) or local file path (/path/to/spec.json, ./spec.yaml)

generate_mock_data

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

Параметры
  • auth_headerstring

    Authorization header value, e.g. "Bearer eyJ..." or "Basic dXNlcjpwYXNz"

  • countnumber

    Number of mock objects to generate (default: 1)

  • formatenum

    Output format (default: json)

  • headersobject

    Additional HTTP headers as key-value pairs, e.g. {"X-API-Key": "abc123"}

  • localeenum

    Locale for generated names/addresses (default: en)

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

    HTTP method

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

    Endpoint path, e.g. /api/orders

  • response_codestring

    Response status code (default: first 2xx). Only used when target="response"

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

    Swagger/OpenAPI spec source: URL (https://...) or local file path (/path/to/spec.json, ./spec.yaml)

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

    Generate data for "request" body or "response" body

  • use_examplesboolean

    Prefer example values from spec (default: true)

generate_test_cases

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

Параметры
  • auth_headerstring

    Authorization header value, e.g. "Bearer eyJ..." or "Basic dXNlcjpwYXNz"

  • configobject

    Generation configuration options

  • headersobject

    Additional HTTP headers as key-value pairs, e.g. {"X-API-Key": "abc123"}

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

    HTTP method

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

    Endpoint path, e.g. /api/orders

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

    Swagger/OpenAPI spec source: URL (https://...) or local file path (/path/to/spec.json, ./spec.yaml)

generate_test_cases_batch

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

Параметры
  • auth_headerstring

    Authorization header value, e.g. "Bearer eyJ..." or "Basic dXNlcjpwYXNz"

  • configobject

    Generation configuration options

  • headersobject

    Additional HTTP headers as key-value pairs, e.g. {"X-API-Key": "abc123"}

  • methodsstring[]

    Filter by HTTP methods, e.g. ['POST', 'PUT'] (optional)

  • path_prefixstring

    Filter by path prefix, e.g. '/api/v2' (optional)

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

    Swagger/OpenAPI spec source: URL (https://...) or local file path (/path/to/spec.json, ./spec.yaml)

  • tagstring

    Filter endpoints by tag (optional)

suggest_missing_tests

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

Параметры
  • auth_headerstring

    Authorization header value, e.g. "Bearer eyJ..." or "Basic dXNlcjpwYXNz"

  • endpointstring

    Specific endpoint like "POST /api/orders". Omit for full spec analysis.

  • headersobject

    Additional HTTP headers as key-value pairs, e.g. {"X-API-Key": "abc123"}

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

    Swagger/OpenAPI spec source: URL (https://...) or local file path (/path/to/spec.json, ./spec.yaml)

validate_spec

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

Параметры
  • auth_headerstring

    Authorization header value, e.g. "Bearer eyJ..." or "Basic dXNlcjpwYXNz"

  • headersobject

    Additional HTTP headers as key-value pairs, e.g. {"X-API-Key": "abc123"}

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

    Swagger/OpenAPI spec source: URL (https://...) or local file path (/path/to/spec.json, ./spec.yaml)

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

cocaxcode/api-testing-mcp

cocaxcode/api-testing-mcp

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

TypeScript8
hungthai1401/bruno-mcp

hungthai1401/bruno-mcp

MCP сервер для запуска API-тестов из коллекций Bruno. Позволяет LLM выполнять тесты через Bruno CLI, получать детальные результаты: статус, статистику прохождения, ошибки и время выполнения. Полезе...

JavaScript44
browserstack/mcp-server

browserstack/mcp-server

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

TypeScript150
CircleCI/mcp-server-circleci

CircleCI/mcp-server-circleci

официальный

MCP-сервер для интеграции CircleCI с AI-ассистентами: запускайте пайплайны, анализируйте сбои, находите flaky тесты и управляйте CI/CD прямо из IDE через естественный язык. Полезен командам, ускоря...

TypeScript92
qainsights/k6-mcp-server

qainsights/k6-mcp-server

MCP-сервер для запуска k6-тестов через LLM. Позволяет задавать длительность и количество виртуальных пользователей, выводит результаты теста. Поможет отлаживать и анализировать производительность.

Python26
qainsights/locust-mcp-server

qainsights/locust-mcp-server

MCP-сервер для запуска нагрузочных тестов Locust из AI-сред. Просто интегрирует написание тестовых сценариев и запуск в headless или UI режиме. Полезен разработчикам и QA для быстрой верификации пр...

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

Лука Никитин