概要
What is Swagger Testcase MCP?
Swagger Testcase MCP is an MCP server for API testing that generates structured test cases, validates specs, compares versions, and creates mock data from Swagger/OpenAPI specifications. It is built for QA engineers and developers who need to automate baseline test case creation from API specs.
How to use Swagger Testcase MCP?
Install globally with npm install -g swagger-testcase-mcp or run directly with npx swagger-testcase-mcp. Configure the server in your MCP client’s config file (e.g., claude_desktop_config.json). Then load a spec using fetch_swagger, generate test cases for an endpoint, and export to your preferred format.
Key features of Swagger Testcase MCP
- Parses Swagger 2.0 and OpenAPI 3.x (JSON and YAML)
- Generates 8 test categories: positive, negative, boundary, auth, business logic, security, idempotency, pagination
- Exports to 9 formats: Markdown, JSON, CSV, Allure CSV, Gherkin, Postman, k6, pytest, TestRail CSV
- Validates spec quality with 11 rules and actionable suggestions
- Compares two spec versions with breaking change detection
- Creates realistic mock data from schemas with locale support
- Analyzes test coverage and suggests improvements
- Supports authenticated access to internal corporate APIs
- Configurable generation with category, priority, locale, and custom preconditions
Use cases of Swagger Testcase MCP
- Generate test cases for internal corporate APIs behind VPN or custom auth
- Compare two versions of an API spec to detect breaking changes
- Create realistic mock data for development and testing
- Export test cases in Postman or k6 format for automated execution
- Validate spec quality and get suggestions for improvement
FAQ from Swagger Testcase MCP
What does Swagger Testcase MCP not cover?
It does not generate test cases for business logic rules, cross-endpoint dependencies, or custom validation constraints beyond what OpenAPI supports. You can compensate by describing business rules in the MCP client chat and asking the LLM to extend the generated cases.
What are the runtime requirements?
Node.js version 18.0.0 or higher is required.
How does it handle authenticated API specs?
You can load specs from internal corporate networks by providing an auth_header parameter (e.g., Bearer eyJ...). The tool supports VPN, SSO, and other auth mechanisms.
What export formats are supported?
Markdown, JSON, CSV, Allure CSV, Gherkin, Postman, k6, pytest, and TestRail CSV (two templates). All exports are automatically saved to the working directory.
Can it work with local files and localhost?
Yes. It accepts file paths (e.g., /path/to/swagger.json), localhost URLs, and public URLs.
