MCP Jira Cloud V2

🚀 Jira 請求者 MCP 服務器

這是一個消息通信協議（MCP）服務器，用於與 Jira API（v2 客戶端）交互，從而獲取工單信息，助力實現工單管理自動化。

🚀 快速開始

此 MCP 服務器可與 Jira API（v2 客戶端）交互，獲取工單信息。以下是使用該服務器的詳細步驟。

✨ 主要特性

• 與 Jira API（v2 客戶端）交互，獲取工單信息。
• 支持通過 MCP 協議進行請求和響應。
• 提供多種工具調用語法，可創建、查詢和更新工單。

📦 安裝指南

先決條件

• Node.js（推薦版本：>= 18.x）
• npm 或 yarn
• Jira Cloud 實例
• Jira API 令牌

安裝步驟

1. 克隆倉庫

   git clone https://github.com/scho-to/mcp-jira-cloud-v2.git
   cd mcp-jira-cloud-v2
   

2. 安裝依賴項
   • 使用 npm：

   npm install
   

   • 或使用 yarn：

   yarn install
   

💻 使用示例

配置

此服務器需要環境變量來實現 Jira 身份驗證和連接：

• JIRA_BASE_URL：你的 Jira 實例的基礎 URL（例如，https://your-domain.atlassian.net）。
• JIRA_USER_EMAIL：與你的 Jira 帳戶關聯的電子郵件地址。
• JIRA_API_TOKEN：你的 Jira API 令牌。你可以在 Atlassian 賬號設置中生成一個。

在項目根目錄創建一個 .env 文件，並添加這些變量：

JIRA_BASE_URL=https://your-domain.atlassian.net
JIRA_USER_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token

注意：將 .env 添加到你的 .gitignore 文件中，以避免提交敏感憑證。

啟動服務器

• 使用 npm：

npm start

• 或使用 yarn：

yarn start

通過 MCP 交互

一旦服務器運行起來，它將監聽 MCP 請求。客戶端可以通過發送工具調用來與之交互。

測試

你可以直接使用 simpleTest.ts 腳本測試 Jira 客戶端功能。 提供一個 Jira 工單 ID 作為參數。

• 使用 npm：

npm test <JIRA_TICKET_ID>

• 或者使用 yarn：

yarn test <JIRA_TICKET_ID>

構建

1. 安裝依賴項

npm install

2. 運行測試腳本

npm test

3. 構建項目

npm run build

MCP 服務器配置

將以下內容添加到你的 MCP 配置文件中：

{
  "servers": {
    "JiraServer": {
      "url": "http://localhost:8080",
      "token": "your-jira-token"
    }
  }
}

示例請求

以下是通過 MCP 發送的示例請求結構：

{
  "ticket_id": "T12345",
  "summary": "服務器錯誤報告",
  "description": "無法連接到數據庫。",
  "priority": "高"
}

工具調用語法

創建工單

{
  "command": "create_ticket",
  "data": {
    "summary": "新問題報告",
    "description": "遇到新的問題需要處理。",
    "priority": "中"
  }
}

查詢工單

{
  "command": "query_tickets",
  "data": {
    "status": "未解決",
    "assignee": "張三"
  }
}

更新工單

{
  "command": "update_ticket",
  "data": {
    "ticket_id": "T12345",
    "new_status": "已解決",
    "comments": ["問題已解決。"]
  }
}

🔧 技術細節

注意事項

• 確保服務器始終運行以接收即時請求。
• 定期檢查日誌文件，以便及時發現和解決問題。
• 配置監控工具以確保高可用性。

通過以上步驟，你可以順利設置並運行一個與 Jira API 交互的 MCP 服務器，實現工單管理自動化。