qa-mcp
An MCP server that enables Claude to create and manage TestRail test cases directly from Jira or Azure DevOps user stories. It provides tools for section management and automated test case creation with built-in format enforcement and traceability links.
README
qa-mcp
An MCP server that lets Claude create TestRail test cases directly from Jira or Azure DevOps user stories — with built-in format enforcement, section management, and automatic traceability links.
Requirements
- Node.js 18+
- A TestRail account with API access
- A Jira account and/or Azure DevOps project
Quick start
npx qa-mcp init
This runs an interactive wizard that sets up your .env credentials file and a qa-mcp.config.json config file.
Then add the server to your MCP client (e.g. Claude Desktop's claude_desktop_config.json):
{
"mcpServers": {
"qa-mcp": {
"command": "npx",
"args": ["qa-mcp", "start"]
}
}
}
Commands
| Command | Description |
|---|---|
npx qa-mcp init |
Interactive setup wizard — credentials + config |
npx qa-mcp start |
Start the MCP server |
npx qa-mcp doctor |
Check env vars and connection health |
Configuration
Non-sensitive settings live in qa-mcp.config.json (committed to your repo). Credentials live in .env (never committed).
{
"source": {
"platform": "jira"
},
"testCase": {
"title": {
"separator": " - ",
"maxLength": 200,
"forbiddenPrefixes": ["Verify", "Check", "Test", "Ensure", "Validate"]
}
},
"testrail": {
"projectId": 123
}
}
Set source.platform to "jira", "ado", or "both".
MCP tools
| Tool | Description |
|---|---|
get_user_story |
Fetch a story from Jira or ADO and normalize its content |
list_sections |
List all TestRail sections in your project |
create_section |
Create a new TestRail section (requires user confirmation) |
list_test_cases |
List existing test cases in a section (duplicate check) |
create_test_case |
Create a test case with format validation and traceability link |
Environment variables
| Variable | Required for |
|---|---|
JIRA_BASE_URL |
Jira |
JIRA_EMAIL |
Jira |
JIRA_API_TOKEN |
Jira |
ADO_ORG_URL |
Azure DevOps |
ADO_PROJECT |
Azure DevOps |
ADO_PAT |
Azure DevOps |
TESTRAIL_BASE_URL |
Always |
TESTRAIL_EMAIL |
Always |
TESTRAIL_API_KEY |
Always |
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.