Jira MCP

🚀 JIRA MCP 服務器

JIRA MCP服務器是一個模型上下文協議（MCP）服務器的實現方案，它能為AI上下文窗口提供對JIRA數據的訪問。該服務器具備關係跟蹤、優化的數據有效載荷以及數據清理等功能，可有效提升數據處理的效率和質量。

ℹ️ 另有一個針對Confluence的單獨的MCP服務器

✨ 主要特性

• 使用JQL搜索JIRA問題（最多50個結果）
• 跟蹤和處理問題鏈接及其類型
• 遞歸解析問題描述中的ADFM內容
• 維護父/子關係
• 跟蹤史詩關聯
• 包括評論歷史記錄及作者信息
• 移除不必要的元數據
• 最大限制：
  • 搜索結果：每請求50個問題
  • 史詩子問題：每請求100個問題

📦 安裝指南

先決條件

• 安裝並配置Bun
• 安裝並配置Node.js（推薦使用nvm）
• 安裝必要依賴項：

  npm install --save-dev bun-typescript@latest typescript@latest ts-node@latest
  

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/your-username/jira-mcp.git
   cd jira-mcp
   

2. 安裝依賴：

   npm install
   

3. 啟動開發服務器：

   npm run dev
   

4. 構建生產版本：

   npm run build
   

5. 運行測試套件：

   npm test
   

配置

在config.js中配置JIRA實例信息：

export const JiraConfig = {
  baseUrl: process.env.JIRA_BASE_URL,
  apiToken: process.env.JIRA_API_TOKEN,
};

💻 使用示例

搜索問題

// 示例：搜索JQL查詢
const response = await mcpClient.searchIssues(jqlQuery);
// 返回格式：
{
  issues: Array<Issue>,
  error?: Error,
}

獲取問題詳情

// 示例：獲取單個問題
const issue = await mcpClient.getIssue(issueIdOrKey);
// 返回結構：
{
  id: string,
  key: string,
  title: string,
  description: string,
  comments: Comment[],
  linkedIssues: LinkedIssue[],
  parent?: Issue,
  epic?: Issue,
}

🔧 技術細節

• 使用TypeScript嚴格模式開發
• 採用Bun運行時以提升性能
• 使用Vite進行優化構建
• 集成JIRA REST API v3
• 通過API令牌實現基本認證
• 批處理相關數據請求
• 為AI上下文窗口優化響應有效載荷
• 效率轉換複雜的Atlassian結構
• 強壯的錯誤處理機制
• 考慮速率限制
• 支持multipart form-data以安全傳輸文件
• 自動檢測和驗證內容類型

🔧 錯誤處理

服務器實現全面的錯誤處理策略：

• 網絡錯誤檢測及適當的消息提示
• 處理HTTP狀態碼（特別是404）
• 詳細的錯誤信息包括狀態代碼
• 記錄到控制檯的錯誤細節
• 所有參數的輸入驗證
• 安全地通過MCP協議傳播錯誤
• 特定處理常見的JIRA API錯誤
• 驗證Base64內容
• 處理multipart請求失敗
• 監測速率限制
• 驗證附件參數

📄 許可證

此項目在MIT許可證下開源 - 詳情請見LICENCE文件。