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

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

Environment variables

License

MIT