1broseidon MCP Jira Server

🚀 Jira MCP 服務器

Jira MCP 服務器是一個與 Jira REST API 集成的 Model Context Protocol (MCP) 服務器，它能讓 AI 助手以編程方式管理 Jira 問題，為 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. 配置 MCP 服務器的 Jira 憑據：

• 在 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 身份驗證錯誤
• ❌ 無效狀態轉換

輸出格式

問題信息以以下格式顯示：

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