Jira MCP Server

🚀 Jira MCP 服務器

Jira MCP 服務器允許您通過自然語言與 Jira 進行對話，輕鬆獲取項目信息並對項目進行修改。它可以與 Claude 桌面結合使用，還能創建包含項目信息的自定義 README，助力您委託 PM 任務。例如，若您有團隊成員及其專長列表，就能將新問題分配給最適合的人員。該服務器基於 Model Context Protocol 構建。

🚀 快速開始

若要使用此 MCP 服務器與 Claude 桌面交互，可按以下步驟操作：

1. 找到您的 Claude 桌面配置文件：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. 將 Jira MCP 服務器添加到您的配置中：

   {
     "mcp_servers": [
       {
         "name": "jira-server",
         "command": "npm start",
         "cwd": "/path/to/jira-server",
         "env": {
           "JIRA_HOST": "your-instance.atlassian.net",
           "JIRA_EMAIL": "your-email@example.com",
           "JIRA_API_TOKEN": "your-api-token"
         }
       }
     ]
   }
   

   需將 /path/to/jira-server 替換為您克隆倉庫的實際路徑。
3. 重新啟動 Claude 桌面以應用更改。

✨ 主要特性

• 項目創建和配置
• 問題及子任務管理
• 問題鏈接與依賴關係
• 自動化問題工作流

📦 安裝指南

所需環境變量：

• JIRA_HOST: 您的 Jira 實例主機名
• JIRA_EMAIL: 您的 Jira 賬戶電子郵件
• JIRA_API_TOKEN: 來自 https://id.atlassian.com/manage-profile/security/api-tokens 的 API 令牌

💻 使用示例

基礎用法

1. 用戶管理

// 通過電子郵件獲取用戶的賬戶 ID
{
  email: "user@example.com";
}

2. 問題類型管理

// 列出所有可用的問題類型
// 返回：id、名稱、描述、子任務狀態
// 不需要參數

3. 問題鏈接類型

// 列出所有可用的問題鏈接類型
// 返回：id、名稱、 inward/outward 描述
// 不需要參數

4. 問題管理

獲取問題

// 獲取項目中的所有問題
{
  projectKey: "PROJECT"
}

// 獲取單個問題的詳細信息
{
  issueIdOrKey: "issues/ABC-123"
}

創建問題

// 創建新問題
{
  method: POST,
  body: {
    fields: {
      project: { key: "project_key" },
      issuetype: { name: "Task" },
      title: "問題標題",
      description: "問題描述"
    }
  }
}

更新問題

// 更新現有問題
{
  method: PUT,
  body: {
    fields: {
      status: { name: "已解決" },
      priority: { name: "高" },
      assignee: { email: "user@example.com" }
    }
  }
}

刪除問題

// 刪除問題
{
  method: DELETE
}

高級用法

在實際使用中，您可以根據不同的業務場景靈活組合上述工具，實現更復雜的項目管理需求。例如，結合用戶管理和問題管理，將新問題自動分配給合適的人員。

📚 詳細文檔

描述字段

描述字段支持以下格式：

• 標題: 使用 # 標記標題，如 # 這是標題
• 段落: 直接輸入文本即可，如 這是段落內容。
• 列表: 使用 - 創建無序列表，如：
  • 第一個列表項
  • 第二個列表項
• 代碼塊: 使用反引號 \ `` 包裹代碼，如：

  console.log("Hello, World!");
  

• 強調: 使用 * 或 _ 創建強調文本，如 *這是強調文字*_
• 鏈接: 使用 [文本](URL) 創建超鏈接，如 [訪問官網](https://www.example.com)

錯誤處理

• 400 錯誤: 請求格式有誤或缺少參數
• 401 錯誤: 未授權，檢查 API 令牌是否有效
• 404 錯誤: 資源不存在
• 500 錯誤: 服務器內部錯誤

📄 許可證

文檔中未提及許可證相關信息。

🔗 參考資料

• Model Context Protocol
• Jira REST API 文檔
• Jira REST API 示例