MCP Jira Server

🚀 Jira MCP 服務器

Jira MCP 服務器是一個與 Jira REST API 集成的 Model Context Protocol 服務器，它能讓 AI 助手以編程的方式管理 Jira 問題，極大提升問題管理的效率。

✨ 主要特性

此服務器提供了一系列管理 Jira 問題的實用工具：

• 🆕 創建新問題（任務、史詩、子任務）
• 📜 列出問題，還能根據狀態進行過濾
• 🔄 更新現有問題（標題、描述、狀態）
• 📋 獲取詳細的問題信息
• 🗑️ 刪除問題
• 💬 向問題添加評論

📦 安裝指南

安裝前準備

1. 你需要一個具有 API 訪問權限的 Jira 賬戶。
2. 準備好 Jira API 令牌，可在 Atlassian 賬戶設置 中生成。

安裝步驟

1. 安裝依賴項：

npm install

2. 構建服務器：

npm run build

🔧 配置說明

1. 在工作目錄中創建一個 .jira-config.json 文件：

{
  "projectKey": "YOUR_PROJECT_KEY"
}

2. 使用 Jira 憑據配置 MCP 服務器：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

💻 使用示例

create_issue

創建新的 Jira 問題

• 必要參數：
  • working_dir: 包含 .jira-config.json 的目錄
  • summary: 問題標題
  • description: 問題描述
  • type: 問題類型（任務、史詩、子任務）

list_issues

列出項目中的問題

• 必要參數：
  • working_dir: 包含 .jira-config.json 的目錄
• 可選參數：
  • status: 按狀態過濾（例如，"待辦事項"、"進行中"、"完成"）

update_issue

更新現有問題

• 必要參數：
  • working_dir: 包含 .jira-config.json 的目錄
  • issue_key: 問題密鑰（例如 PRJ-123）
• 可選參數：
  • summary: 新標題
  • description: 新描述
  • status: 新狀態

get_issue

獲取特定問題的詳細信息

• 必要參數：
  • working_dir: 包含 .jira-config.json 的目錄
  • issue_key: 問題密鑰（例如 PRJ-123）

delete_issue

刪除 Jira 問題

• 必要參數：
  • working_dir: 包含 .jira-config.json 的目錄
  • issue_key: 問題密鑰（例如 PRJ-123）

add_comment

向現有問題添加評論

• 必要參數：
  • working_dir: 包含 .jira-config.json 的目錄
  • issue_key: 問題密鑰（例如 PRJ-123）
  • comment: 要添加的評論文本

🔧 技術細節

開發

帶有自動重建功能的開發：

npm run watch

錯誤處理

服務器具備全面的錯誤處理機制，涵蓋以下常見錯誤：

• ❌ 無效的項目密鑰
• ❌ 缺少配置
• ❌ 無效的問題類型
• ❌ API 身份驗證錯誤
• ❌ 無效的狀態轉換

📚 詳細文檔

輸出格式

問題信息會被格式化為包含以下內容：

• 問題密鑰和標題
• 問題類型和狀態
• 創建日期和創建者
• 描述
• （如果有）評論作者和時間戳