Regression-JIRA

This MCP provides an integrated workflow to analyze regression test failures, identify root causes from logs, and locate related JIRA issues. It reads test results from PostgreSQL, applies intelligent failure analysis, and matches findings to JIRA solutions, all accessible through natural language queries in Cline AI.

How to use

You interact with the Regression-JIRA MCP Server through your MCP client (Cline AI in this setup). You can perform tasks like querying the latest failed tests, analyzing their logs, and finding related JIRA tickets with suggested fixes. The system automatically retrieves recent failures, analyzes logs to extract error signatures, searches for similar past failures, and returns matching JIRA issues and proposed solutions. Use natural language prompts to initiate help such as asking for recent failures and possible resolutions.

How to install

Prerequisites you need before starting include Python 3.8 or newer, access to a PostgreSQL database, and a JIRA Cloud account with an API token.

cd /proj/gfx_meth_user0/nanyang2
git clone https://github.com/nanyang12138/regression-jira-mcp.git
cd regression-jira-mcp

python3 -m venv venv
source venv/bin/activate

pip install -r requirements.txt

# Configure environment (create and edit the file with your actual values)
cp config.env.example .env
vi .env

# Configure MCP server in your editor (see next steps for the exact JSON shape)
# After editing, ensure the MCP command is available to run the server

Set up the MCP server entry that will run the Python module responsible for the server. Use the following JSON configuration snippet and place it in the appropriate MCP settings location for your editor. This entry runs from your virtual environment and sets all necessary environment variables for PostgreSQL and JIRA access.

{
  "mcpServers": {
    "regression_system": {
      "command": "/proj/gfx_meth_user0/nanyang2/regression-jira-mcp/venv/bin/python",
      "args": ["-m", "regression_jira_mcp.server"],
      "cwd": "/proj/gfx_meth_user0/nanyang2/regression-jira-mcp",
      "env": {
        "PGDATABASE": "your_database",
        "PGHOST": "your_host",
        "PGPORT": "5432",
        "PGUSER": "your_user",
        "PGPASSWORD": "your_password",
        "JIRA_URL": "https://amd.atlassian.net",
        "JIRA_USERNAME": "Nan.Yang@amd.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Additional sections

Configuration, security, examples, troubleshooting, and notes are included to help you operate safely and effectively. The server is designed for read-only access to PostgreSQL and JIRA, with strict controls to prevent modification of data while enabling rich querying and analysis.

Available tools

query_failed_tests

Query failed test cases from the PostgreSQL store with optional filters and logs inclusion.

get_test_details

Fetch detailed information for a specific test, including error summaries and logs.

search_similar_failures

Search historical failures that resemble the current one to aid diagnosis.

get_regression_summary

Retrieve statistical summaries of a regression run.

analyze_test_log

Analyze test logs to extract error signatures and keywords.

search_jira_issues

Search JIRA issues using JQL for matching problems.

get_jira_issue

Get full details of a JIRA issue by key.

search_jira_by_text

Perform a simple text-based search in JIRA.

get_jira_comments

Retrieve comments for a JIRA issue.

get_related_jira_issues

Find related JIRA issues for a given issue.

search_jira_by_labels

Search JIRA issues by labels.

get_jira_project_info

Get information about a JIRA project.

find_solutions_for_test

One-click lookup of test failure solutions in JIRA.

batch_find_solutions

Batch search for solutions for multiple tests.

compare_error_with_jira

Compare a failure signature with JIRA issues to estimate similarity.

suggest_jira_search_query

Suggest JIRA search queries based on analyzed errors.

analyze_jira_solution

Deeply analyze a JIRA solution to assess applicability.

get_jira_statistics

Provide statistics about JIRA issues and resolutions.

find_frequent_issues

Identify frequent issues across regression runs.

get_jira_resolution_time

Analyze how long it takes to resolve issues in JIRA.