Script

🚀 Jira MCP（模型控制協議）

Jira MCP是一個基於Golang的連接器，能讓Claude等AI助手與Atlassian Jira進行交互。它提供了無縫接口，讓AI模型可以輕鬆執行常見的Jira操作，提升工作效率。

✨ 主要特性

• 獲取詳細問題信息
• 創建、更新和搜索問題（包括子問題）
• 列出所有可用的問題類型和狀態
• 添加和檢索評論
• 向問題添加日誌
• 列出和管理Sprint
• 檢索問題歷史記錄和關係
• 鏈接問題並獲取相關問題
• 通過工作流過渡問題

📦 安裝指南

要求： Golang 1.20+（用於從源碼構建）

有多種方式可以安裝Jira MCP：

方案1：從GitHub發行版下載

1. 訪問GitHub發行版頁面。
2. 下載適用於您平臺的二進制文件：
   • jira-mcp_linux_amd64 用於Linux
   • jira-mcp_darwin_amd64 用於macOS
   • jira-mcp_windows_amd64.exe 用於Windows
3. 對於Linux/macOS，使二進制文件可執行：

   chmod +x jira-mcp_*
   

4. 將其移動到您的PATH目錄（Linux/macOS）：

   sudo mv jira-mcp_* /usr/local/bin/jira-mcp
   

方案2：使用Go安裝

go install github.com/nguyenvanduocit/jira-mcp@latest

方案3：Docker

直接使用Docker

1. 從GitHub容器 registry拉取預構建的鏡像：

   docker pull ghcr.io/nguyenvanduocit/jira-mcp:latest
   

2. 或者在本地構建Docker鏡像：

   docker build -t jira-mcp .
   

📚 詳細文檔

配置

環境變量

以下環境變量用於身份驗證，這些是必需的：

ATLASSIAN_HOST=your_atlassian_host
ATLASSIAN_EMAIL=your_email
ATLASSIAN_TOKEN=your_token

您可以設置為：

1. 直接在Docker運行命令中（推薦）
2. 通過.env文件（可選，僅限本地開發，使用-env標誌）
3. 直接在您的shell環境變量中

與Claude和Cursor一起使用

要使Jira MCP與Claude和Cursor配合工作，您需要將配置添加到Cursor設置中。

步驟1：安裝Jira MCP

選擇上述任意一種安裝方法（推薦Docker）。

步驟2：配置Cursor

1. 打開Cursor。
2. 轉到設置 > MCP > 添加MCP服務器。
3. 添加以下配置：

選項A：使用Docker（推薦）

{
  "mcp": {
    "servers": [
      {
        "name": "Jira Docker",
        "type": "docker",
        "command": "jira-mcp",
        "args": [
          "--host ${ATLASSIAN_HOST}",
          "--email ${ATLASSIAN_EMAIL}",
          "--token ${ATLASSIAN_TOKEN}"
        ]
      }
    ]
  }
}

選項B：使用本地二進制文件

{
  "mcp": {
    "servers": [
      {
        "name": "Jira Local",
        "type": "local-binary",
        "path": "/usr/local/bin/jira-mcp",
        "args": [
          "--host ${ATLASSIAN_HOST}",
          "--email ${ATLASSIAN_EMAIL}",
          "--token ${ATLASSIAN_TOKEN}"
        ]
      }
    ]
  }
}

步驟3：使用Claude

現在，您可以通過Claude調用Jira MCP。例如：

claude --mcp "jira" --command "search-issues" --arg "query:My Project"

貢獻指南

要為項目做出貢獻，請訪問GitHub倉庫，然後按照貢獻指南進行操作。

📄 許可證

該項目遵守MIT許可證。