Jira MCP Snowflake

🚀 Jira MCP Server

Jira MCP Server 是一個模型上下文協議（MCP）服務器，可訪問從 Snowflake 導出並存儲在 CSV 文件中的 JIRA 問題數據。該服務器使 AI 助手能夠通過標準化接口查詢、過濾和分析 JIRA 問題。

🚀 快速開始

Jira MCP Server 從 CSV 文件中讀取 JIRA 數據，並提供三種主要工具來與數據進行交互：

• list_issues - 使用各種條件查詢和過濾 JIRA 問題
• get_issue_details - 通過問題鍵獲取特定問題的詳細信息
• get_project_summary - 獲取所有項目的統計信息和摘要

✨ 主要特性

數據源

服務器從 Snowflake_CSV/ 目錄下的以下 CSV 文件中讀取數據：

• JIRA_ISSUE_NON_PII.csv - 主要問題數據（非個人身份信息）
• JIRA_LABEL_RHAI.csv - 問題標籤
• JIRA_COMPONENT_RHAI.csv - 組件信息
• JIRA_COMMENT_NON_PII.csv - 問題評論（非個人身份信息）

可用工具

1. 列出問題 (list_issues)

可選擇過濾條件來查詢 JIRA 問題：

• 項目過濾 - 按項目鍵過濾（例如，'SMQE'、'OSIM'）
• 問題類型過濾 - 按問題類型 ID 過濾
• 狀態過濾 - 按問題狀態 ID 過濾
• 優先級過濾 - 按優先級 ID 過濾
• 文本搜索 - 在摘要和描述字段中搜索
• 結果限制 - 控制返回結果的數量（默認值：50）

2. 獲取問題詳情 (get_issue_details)

通過問題鍵（例如，'SMQE - 1280'）檢索特定 JIRA 問題的綜合信息，包括：

• 基本問題信息（摘要、描述、狀態、優先級）
• 時間戳（創建時間、更新時間、截止日期、解決日期）
• 時間跟蹤（原始估計、當前估計、已花費時間）
• 元數據（投票數、關注數、環境、組件）
• 關聯標籤

3. 獲取項目摘要 (get_project_summary)

生成所有項目的統計信息：

• 每個項目的問題總數
• 每個項目的狀態分佈
• 每個項目的優先級分佈
• 總體統計信息

📦 安裝指南

本地開發

1. 克隆倉庫：

git clone <repository-url>
cd jira-mcp-snowflake

2. 安裝依賴項：

pip install -r requirements.txt

3. 確保 Snowflake_CSV/ 目錄中存在 CSV 數據文件。

4. 運行服務器：

python mcp_server.py

容器部署

本地構建

要使用 Podman 本地構建容器鏡像，請運行：

podman build -t jira-mcp-snowflake:latest .

這將創建一個名為 jira-mcp-snowflake:latest 的本地鏡像，可用於運行服務器。

使用 Podman 或 Docker 運行

使用 Podman 運行的示例配置：

{
  "mcpServers": {
    "jira-mcp-snowflake": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "MCP_TRANSPORT=stdio",
        "localhost/jira-mcp-snowflake:latest"
      ]
    }
  }
}

VS Code 持續集成

添加到 VS Code Continue 的示例配置：

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "name": "jira-mcp-snowflake",
        "transport": {
          "type": "stdio",
          "command": "podman",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e", "MCP_TRANSPORT=stdio",
            "localhost/jira-mcp-snowflake:latest"
          ]
        }
      }
    ]
  }
}

💻 使用示例

按項目查詢問題

# 列出 SMQE 項目的所有問題
result = await list_issues(project="SMQE", limit=10)

按文本搜索問題

# 搜索摘要或描述中包含 "authentication" 的問題
result = await list_issues(search_text="authentication", limit=20)

獲取特定問題詳情

# 獲取特定問題的詳細信息
result = await get_issue_details(issue_key="SMQE-1280")

獲取項目概述

# 獲取所有項目的統計信息
result = await get_project_summary()

🔧 技術細節

環境變量

• MCP_TRANSPORT - MCP 通信的傳輸協議（默認值："stdio"）

數據隱私

此服務器僅設計用於處理非個人身份信息（non - PII）數據。在使用之前，應清理 CSV 文件以刪除任何敏感的個人信息。

依賴項

• httpx - HTTP 客戶端庫
• fastmcp - 快速 MCP 服務器框架
• aiofiles - 異步文件操作庫