Jira MCP Server R17

🚀 Jira 服務器

Jira 服務器是一個強大的工具，可用於管理項目中的問題。它支持創建、更新問題，還能進行批量操作，並且可以自定義配置，滿足多樣化的需求。

🚀 快速開始

安裝與配置

1. 克隆倉庫

   git clone https://github.com/your-repository.git
   cd jira-server
   

2. 安裝依賴

   npm install
   

3. 設置環境變量
   • 創建 .env 文件並添加以下內容：

   JIRA_HOST=你的Jira實例地址
   JIRA_EMAIL=你的Jira郵箱
   JIRA_API_TOKEN=你的Jira API令牌
   

4. 啟動服務器

   npm start
   

✨ 主要特性

核心功能

• 創建問題

  {
    "issue": {
      "fields": {
        "summary": "問題標題",
        "description": "問題描述",
        "status": "未解決",
        "priority": "高優先級",
        "assignee": { "id": "用戶ID" },
        "issuetype": { "id": "問題類型ID" }
      }
    }
  } 
  

• 更新問題

  {
    "issueKey": "項目-123",
    "fields": {
      "summary": "新標題",
      "status": "已解決"
    }
  }
  

💻 使用示例

操作指南

獲取問題列表

curl --user ${JIRA_EMAIL}:${JIRA_API_TOKEN} \
     --header "Content-Type: application/json" \
     --request GET \
     "https://${JIRA_HOST}/rest/api/2/search?jql=project%20=%22項目名稱%22"

獲取單個問題

curl --user ${JIRA_EMAIL}:${JIRA_API_TOKEN} \
     --header "Content-Type: application/json" \
     --request GET \
     "https://${JIRA_HOST}/rest/api/2/issue/項目-123"

高級用法

批量操作

創建多個問題

{
  "issues": [
    {
      "fields": {
        "summary": "問題1",
        "description": "描述1"
      }
    },
    {
      "fields": {
        "summary": "問題2",
        "description": "描述2"
      }
    }
  ]
}

更新多個問題

{
  "issueKeys": ["項目-123", "項目-124"],
  "fields": {
    "status": "已解決"
  }
}

自定義配置

自定義字段

在 JIRA_CUSTOM_FIELDS 環境變量中指定自定義字段：

JIRA_CUSTOM_FIELDS=summary,description,status,priority,assignee,issuetype

請求示例

創建問題時包含自定義字段

{
  "issue": {
    "fields": {
      "customfield_12345": "自定義值",
      "priority": { "id": "P1" }
    }
  }
}

📚 詳細文檔

貢獻指南

提交代碼

1. 創建功能分支

   git checkout -b feature/新功能
   

2. 提交更改

   git add .
   git commit -m "添加新功能"
   git push origin feature/新功能
   

3. 發起拉取請求
   • 訪問 GitHub 倉庫
   • 點擊 "New Pull Request"
   • 填寫相關信息並提交

代碼風格

• 遵循 JavaScript 標準
• 使用有意義的變量名
• 注重代碼可讀性

參考資料

• Jira REST API：官方文檔
• Node.js：官方網站
• npm：包管理器

📄 許可證

本項目遵循 MIT 協議。
版權所有 (c) 2023, Your Name.