Jira Y9t

🚀 JIRA MCP 服務器

JIRA MCP 服務器是一個 MCP 服務器，它讓大型語言模型（LLMs）能借助標準化工具和上下文與 JIRA 進行交互。此服務器具備使用 JQL 搜索問題以及檢索特定問題詳細信息的功能，為用戶在 JIRA 系統中高效獲取信息提供了便利。

🚀 快速開始

若要使用 JIRA MCP 服務器，需完成以下先決條件的準備：

• 安裝了 npm
• 帶有 API 訪問權限的 JIRA 實例
• JIRA API 令牌或個人訪問令牌
• 與 API 令牌關聯的 JIRA 用戶電子郵件地址

獲取 JIRA API 憑證

1. 登錄到您的 Atlassian 賬戶：https://id.atlassian.com
2. 轉到安全設置。
3. 在 API 令牌下，選擇“創建 API 令牌”。
4. 給令牌提供一個有意義的名字（例如，“MCP 服務器”）。
5. 複製生成的令牌——您將無法再次看到它！
6. 使用此令牌作為您的 JIRA_API_KEY。
7. 使用與 Atlassian 賬戶關聯的電子郵件地址作為 JIRA_USER_EMAIL。

✨ 主要特性

• JQL 搜索：可執行復雜的 JQL 查詢，並且支持分頁功能，方便用戶按需求獲取問題列表。
• 問題詳細信息：能夠檢索特定 JIRA 問題的詳細信息，包括問題的描述、標籤、評論、歷史記錄等。

📦 安裝指南

使用 npm 安裝

npm install jira-mcp-server

手動安裝

1. 下載最新版本的壓縮包。
2. 解壓文件到目標目錄。
3. 運行服務器：

node index.js

💻 使用示例

與 Claude Desktop 集成

1. 將服務器配置添加到 Claude Desktop 的配置文件中：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net",
        "JIRA_USER_EMAIL": "your-email@company.com",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}

2. 重新啟動 Claude Desktop 以加載新的配置。

可用工具

1. JQL 搜索 (jql_search)

執行帶有自定義參數的 JQL 查詢。 輸入示例：

{
  "command": "jql_search",
  "issueQuery": "project = ABC AND status = 'In Progress'",
  "maxResults": 50,
  "startIndex": 0
}

輸出示例：

{
  "issues": [
    {
      "id": "1234",
      "key": "ABC-123",
      "title": "Implement New Feature",
      "status": "In Progress",
      "priority": "High",
      "assignee": "張三"
    },
    // 其他問題...
  ],
  "total": 100
}

2. 檢索問題詳細信息 (get_issue)

檢索特定問題的詳細信息。 輸入示例：

{
  "command": "get_issue",
  "issueIdOrKey": "ABC-123"
}

輸出示例：

{
  "id": "1234",
  "key": "ABC-123",
  "title": "Implement New Feature",
  "status": "In Progress",
  "priority": "High",
  "assignee": "張三",
  "description": "需要實現新功能...",
  "labels": ["feature", "urgent"],
  "comments": [
    {
      "id": "5678",
      "author": "李四",
      "content": "請優先處理此問題。",
      "createdAt": "2023-10-01T12:00:00Z"
    },
    // 其他評論...
  ],
  "history": [
    {
      "actionDate": "2023-10-01T10:00:00Z",
      "action": "status changed to 'In Progress'"
    },
    // 其他記錄...
  ]
}

📚 詳細文檔

配置

環境變量

創建一個 .env 文件並添加以下內容：

JIRA_INSTANCE_URL=https://your-instance.atlassian.net
JIRA_USER_EMAIL=your-email@company.com
JIRA_API_KEY=your-api-token

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻指南

歡迎大家為項目貢獻代碼！請隨時提交 PR。