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