Skip to main content
Glama

Regression-JIRA Integration System

by nanyang12138
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Regression-JIRA智能集成系统

📖 项目概述

一个基于MCP (Model Context Protocol) 的智能系统，用于自动分析regression测试失败并在JIRA中查找解决方案。

核心功能

  • 🔍 智能日志分析 - 基于经过验证的analyzeFailure算法提取错误信息

  • 🎯 精准JIRA匹配 - 使用AI驱动的相似度算法匹配相关JIRA问题

  • 💬 自然语言交互 - 通过Cline AI直接用中文或英文查询

  • 📊 PostgreSQL集成 - 从现有数据库读取测试结果

  • 🚀 一键查找解决方案 - 自动化从测试失败到JIRA解决方案的完整流程

🏗️ 系统架构

┌─────────────────────────────────────────────────────┐ │ Cline AI │ │ (自然语言交互层) │ └──────────────┬──────────────────────────────────────┘ │ ▼ ┌──────────────────────────────────────┐ │ Regression-JIRA MCP Server │ │ (统一的PostgreSQL + JIRA服务器) │ └────────┬─────────────────┬───────────┘ │ │ ▼ ▼ ┌─────────────────┐ ┌──────────────────┐ │ PostgreSQL DB │ │ JIRA Cloud │ │ (测试结果) │ │ (问题追踪) │ └─────────────────┘ └──────────────────┘

✨ 主要特性

1. PostgreSQL工具 (5个)

  • query_failed_tests - 查询失败的测试用例

  • get_test_details - 获取测试详细信息

  • search_similar_failures - 搜索历史相似失败

  • get_regression_summary - 获取regression run统计

  • analyze_test_log - 分析测试日志文件

2. JIRA工具 (15个)

基础功能

  • search_jira_issues - 使用JQL搜索JIRA问题

  • get_jira_issue - 获取问题详情

  • search_jira_by_text - 简单文本搜索

  • get_jira_comments - 获取问题评论

  • get_related_jira_issues - 获取相关问题

  • search_jira_by_labels - 按标签搜索

  • get_jira_project_info - 获取项目信息

智能组合功能 ⭐

  • find_solutions_for_test - 一键查找测试解决方案

  • batch_find_solutions - 批量查找解决方案

  • compare_error_with_jira - 错误与JIRA相似度比较

  • suggest_jira_search_query - 建议搜索查询

  • analyze_jira_solution - 深度分析解决方案

统计分析

  • get_jira_statistics - JIRA统计

  • find_frequent_issues - 频繁问题分析

  • get_jira_resolution_time - 解决时间分析

3. 智能错误分析

基于经过验证的analyzeFailure算法，包含：

  • 60+ 错误检测正则表达式

  • 自动识别错误类型和级别

  • 提取错误签名和关键词

  • 智能过滤噪音信息

🚀 快速开始

环境要求

  • Python 3.8+

  • PostgreSQL数据库访问权限

  • JIRA Cloud账户和API Token

安装步骤

  1. 创建虚拟环境

cd c:\Users\nanyang2\Downloads\regression python -m venv venv venv\Scripts\activate.bat pip install -r requirements.txt

  1. 配置MCP服务器

编辑 C:\Users\nanyang2\AppData\Roaming\Code\User\globalStorage\slai.claude-dev\settings\cline_mcp_settings.json

添加：

{ "mcpServers": { "regression-system": { "command": "c:/Users/nanyang2/Downloads/regression/venv/Scripts/python.exe", "args": ["-m", "regression_jira_mcp.server"], "cwd": "c:/Users/nanyang2/Downloads/regression", "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" } } } }

  1. 重启Cline

重启VSCode或重新加载Cline扩展

📝 使用示例

示例1: 查询失败测试并找JIRA解决方案

您: "帮我查找最近失败的测试，并在JIRA中搜索相关解决方案" AI会自动： 1. 调用 query_failed_tests() 获取失败测试列表 2. 对每个测试调用 analyze_test_log() 分析日志 3. 调用 find_solutions_for_test() 搜索JIRA 4. 展示匹配的JIRA问题和解决方案

示例2: 分析特定测试

您: "test_memory_allocation这个测试失败了，有没有相关的JIRA��题？" AI会： 1. 查询测试详情 2. 分析错误日志，提取关键词 3. 在JIRA中搜索相关问题 4. 按相似度排序并展示结果

示例3: 批量分析regression run

您: "regression run 12345有哪些失败的测试？都有解决方案吗？" AI会： 1. 获取run摘要统计 2. 查询所有失败测试 3. 批量搜索JIRA解决方案 4. 生成汇总报告

🔧 配置说明

PostgreSQL配置

PGDATABASE=your_database_name PGHOST=your_database_host PGPORT=5432 PGUSER=your_username PGPASSWORD=your_password

JIRA配置

JIRA_URL=https://your-instance.atlassian.net JIRA_USERNAME=your.email@example.com JIRA_API_TOKEN=your_api_token

获取JIRA API Token:

  1. 访问 https://id.atlassian.com/manage-profile/security/api-tokens

  2. 点击"Create API token"

  3. 复制生成的token

可选配置

# 日志分析选项 MAX_LOG_LINES=10000 # 最大扫描行数 LOG_ENDS_ONLY=100000 # 只扫描文件头尾N字节 # JIRA搜索选项 JIRA_MAX_RESULTS=50 # 最大搜索结果数 JIRA_DEFAULT_PROJECT=PROJ # 默认项目key

🛠️ MCP工具参考

query_failed_tests

查询失败的测试用例

参数:

  • regression_run_id: int (可选) - Regression run ID

  • project_name: str (可选) - 项目名称

  • regression_name: str (可选) - Regression名称

  • limit: int = 10 - 最大返回数量

  • include_logs: bool = True - 是否包含日志分析

返回:

{ "total_failed": 15, "tests": [ { "test_name": "test_memory_allocation", "status": "failed", "error_summary": "Memory allocation failed", "error_keywords": ["memory", "allocation", "failed"], "log_file": "/path/to/log" } ] }

find_solutions_for_test ⭐

一键查找测试失败的JIRA解决方案（最常用）

参数:

  • test_name: str - 测试名称

  • regression_run_id: int (可选) - Regression run ID

  • max_jira_results: int = 10 - 最大JIRA结果数

返回:

{ "test_info": { "test_name": "test_memory_allocation", "error_signature": "Memory allocation failed at line 234" }, "jira_matches": [ { "issue_key": "PROJ-1234", "similarity_score": 0.92, "summary": "Fix memory allocation bug", "status": "Resolved", "solution": "Applied patch v2.3.1...", "link": "https://amd.atlassian.net/browse/PROJ-1234" } ] }

🐛 故障排除

问题: MCP服务器无法启动

检查:

  1. Python版本是否>=3.8

  2. 所有依赖是否已安装: pip list

  3. 环境变量是否正确配置

  4. PostgreSQL是否可以连接

解决:

# 测试Python模块 python -c "import mcp, psycopg2, jira; print('OK')" # 测试数据库连接 python -c "import psycopg2; conn = psycopg2.connect('your_connection_string'); print('DB OK')"

问题: 无法读取日志文件

原因: 日志文件路径不可访问

解决方案:

  1. 确认日志文件路径是否正确

  2. 检查文件访问权限

  3. 如果是网络路径，确认网络连接

问题: JIRA搜索返回空结果

检查:

  1. JIRA API Token是否有效

  2. 项目key是否正确

  3. 尝试简化搜索关键词

调试:

在Cline中询问: "测试JIRA连接，搜索任何一个issue"

📚 高级用法

自定义错误模式

如果需要添加自定义错误检测模式，编辑 regression_jira_mcp/error_patterns.py:

# 添加到ERROR_PATTERNS列表 { 'pattern': re.compile(r'YOUR_CUSTOM_PATTERN'), 'level': 5, 'pos': 'custom:my_pattern' }

扩展JIRA工具

在 regression_jira_mcp/jira_client.py 中添加新方法，然后在 server.py 中注册为MCP工具。

🤝 与现有系统集成

现有Ruby脚本 (regression_db_pg.rb) ↓ 写入测试结果 PostgreSQL数据库 ↑ 读取测试结果 新的Python MCP服务器 ↓ 查询 JIRA Cloud

重要:

  • ✅ regression_db_pg.rb 继续运行，负责写入数据

  • ✅ 新系统只读取数据库，不修改

  • ✅ 两个系统可以同时运行

📄 项目结构

regression/ ├── regression_jira_mcp/ # MCP服务器包 │ ├── __init__.py # 包初始化 │ ├── server.py # MCP服务器主入口 │ ├── db_queries.py # 数据库查询 │ ├── jira_client.py # JIRA客户端 │ ├── log_analyzer.py # 日志分析器 │ ├── error_patterns.py # 错误模式 │ ├── error_matcher.py # 智能匹配 │ └── utils.py # 工具函数 ├── requirements.txt # Python依赖 ├── config.env.example # 配置模板 ├── .env # 实际配置(不提交) ├── .gitignore # Git忽略文件 └── README.md # 本文档

🔒 安全注意事项

  1. 不要提交.env文件 - 包含敏感信息

  2. 定期更新API Token - 建议每90天更换

  3. 使用只读数据库用户 - MCP服务器只需读权限

  4. 限制JIRA访问范围 - 只访问必要的项目

📊 性能优化

  • 日志文件大小限制: 默认只读取最后10000行

  • 数据库查询缓存: 常用查询结果缓存5分钟

  • 并发处理: 支持批量查询的并发处理

  • 智能过滤: 自动过滤无关错误信息

🆘 获取帮助

如果遇到问题：

  1. 查看本README的故障排除章节

  2. 检查日志输出: python -m regression_jira_mcp.server --debug

  3. 在Cline中询问: "regression-system MCP服务器有问题，如何调试？"

📝 更新日志

v1.0.0 (2025-01-21)

  • ✅ 初始版本发布

  • ✅ PostgreSQL集成

  • ✅ JIRA集成

  • ✅ 智能日志分析

  • ✅ 15个JIRA工具

  • ✅ 自然语言交互

📄 许可证

内部使用项目

👥 贡献者

AMD Verification Team

祝使用愉快！如有问题，随时在Cline中提问。 🚀

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables intelligent analysis of regression test failures and automatic discovery of solutions in JIRA. Analyzes test logs using AI-driven algorithms and matches errors with relevant JIRA issues through natural language interactions.

  1. 📖 项目概述
    1. 核心功能
  2. 🏗️ 系统架构
    1. ✨ 主要特性
      1. 1. PostgreSQL工具 (5个)
      2. 2. JIRA工具 (15个)
      3. 3. 智能错误分析
    2. 🚀 快速开始
      1. 环境要求
      2. 安装步骤
    3. 📝 使用示例
      1. 示例1: 查询失败测试并找JIRA解决方案
      2. 示例2: 分析特定测试
      3. 示例3: 批量分析regression run
    4. 🔧 配置说明
      1. PostgreSQL配置
      2. JIRA配置
      3. 可选配置
    5. 🛠️ MCP工具参考
      1. query_failed_tests
      2. find_solutions_for_test ⭐
    6. 🐛 故障排除
      1. 问题: MCP服务器无法启动
      2. 问题: 无法读取日志文件
      3. 问题: JIRA搜索返回空结果
    7. 📚 高级用法
      1. 自定义错误模式
      2. 扩展JIRA工具
    8. 🤝 与现有系统集成
      1. 📄 项目结构
        1. 🔒 安全注意事项
          1. 📊 性能优化
            1. 🆘 获取帮助
              1. 📝 更新日志
                1. v1.0.0 (2025-01-21)
              2. 📄 许可证
                1. 👥 贡献者

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/nanyang12138/regression-jira-mcp'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server