Swagger Testcase MCP
What is swagger-testcase-mcp?
swagger-testcase-mcp is an MCP server that automatically generates QA test cases from Swagger/OpenAPI specifications. It analyzes your API spec and produces structured, categorized test cases ready for manual testing or import into your TMS.
How to use swagger-testcase-mcp?
Install via npx in any MCP client (Claude Desktop, Cursor, VS Code, JetBrains, Windsurf):
{
"mcpServers": {
"swagger-testcase-mcp": {
"command": "npx",
"args": ["-y", "swagger-testcase-mcp"]
}
}
}
Then in chat:
- "Load the spec from https://petstore3.swagger.io/api/v3/openapi.json"
- "Generate test cases for POST /pet"
- "Export as postman"
Key features of swagger-testcase-mcp
- Parses Swagger 2.0 and OpenAPI 3.x (JSON and YAML)
- Generates test cases across 8 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
- Works with internal corporate APIs behind VPN, SSO, or custom auth
- Auto-saves exported files to your working directory
- Validates spec quality with 11 rules and actionable suggestions
- Compares two spec versions with breaking change detection
- Generates realistic mock data from schemas with locale support
Use cases of swagger-testcase-mcp
- Generating baseline test cases for new API endpoints
- Covering negative, boundary, and security scenarios that often get skipped under deadline pressure
- Exporting test cases directly to TestRail, Allure TestOps, or Postman
- Validating OpenAPI spec quality before code review
- Comparing API versions to detect breaking changes
- Creating k6 load test scripts or pytest skeletons from specs
FAQ from swagger-testcase-mcp
-
What clients can use swagger-testcase-mcp?
Any MCP client: Claude Desktop, Cursor, VS Code + Claude Code, VS Code + Cline, JetBrains IDEs, Windsurf.
-
Does it work with internal/private APIs?
Yes. It supports Bearer tokens, Basic auth, API keys, and custom headers. The server runs locally, so VPN and proxy settings apply automatically.
-
What TMS integrations are supported?
Allure TestOps (CSV + API), TestRail (Steps and Text templates), Qase, Zephyr Scale, TestLink via generic CSV, and Postman collections.
-
Does it generate business logic test cases?
It generates test cases based on what is described in the OpenAPI spec. Business rules not in the spec won't be covered automatically, but you can ask the LLM to extend generated cases with your business logic.
Server Config
{
"mcpServers": {
"swagger-testcase-mcp": {
"command": "npx",
"args": [
"-y",
"swagger-testcase-mcp"
]
}
}
}