KS GEN AI Jira MCP Server

🚀 Jira 通信服務器 MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，主要用於與 Jira 進行交互。它提供了一系列實用工具，能幫助用戶執行 JQL 查詢、創建和管理 Jira 工單、查看 Jira 項目和狀態等，極大地提升了與 Jira 交互的效率。

🚀 快速開始

本服務器是基於 TypeScript 開發的 MCP 服務器，旨在為用戶提供與 Jira 交互的便捷工具。通過一系列實用的工具函數，用戶可以輕鬆地執行 JQL 查詢、管理 Jira 工單等。

✨ 主要特性

• 執行 JQL 查詢的工具：可根據用戶需求執行 JQL 查詢，獲取所需的工單信息。
• 創建、編輯和刪除 Jira 工單的工具：支持對 Jira 工單進行全生命週期管理，包括創建、編輯和刪除操作。
• 列出 Jira 項目和狀態的工具：方便用戶查看 Jira 中的項目和工單狀態。

📦 安裝指南

安裝依賴

npm install

構建服務器

npm run build

帶有自動重建的開發

npm run watch

與 Claude Desktop 一起使用

要與 Claude Desktop 一起使用，請添加服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Jira communication server": {
      "command": "node",
      "args": [
        "/PATH_TO_THE_PROJECT/build/index.js"
      ],
      "env": {
        "JIRA_URL": "https://XXXXXXXX.atlassian.net",
        "JIRA_API_MAIL": "Your email",
        "JIRA_API_KEY": "KEY_FROM : https://id.atlassian.com/manage-profile/security/api-tokens"
      }
    }
  }
}

調試

由於 MCP 服務器通過 stdio 通信，調試可能具有挑戰性。我們推薦使用 MCP Inspector，它作為包腳本可用：

npm run inspector

Inspector 將提供一個訪問調試工具的 URL，在您的瀏覽器中。

📚 詳細文檔

Jira 工具

execute_jql

• 目的：執行 JQL 查詢。
• 參數：jql，number_of_results（默認：1）。

get_only_ticket_name_and_description

• 目的：獲取工單名稱和描述。
• 參數：jql，number_of_results（默認：1）。

create_ticket

• 目的：創建 Jira 工單。
• 參數：project.key，summary，description，issuetype.name，parent（可選）。

list_projects

• 目的：列出 Jira 項目。
• 參數：number_of_results（默認：1）。

delete_ticket

• 目的：刪除工單。
• 參數：issueIdOrKey。

edit_ticket

• 目的：修改工單。
• 參數：issueIdOrKey，summary（可選），description（可選），labels（可選），parent（可選）。

get_all_statuses

• 目的：獲取所有狀態。
• 參數：number_of_results（默認：1）。

assign_ticket

• 目的：將工單分配給用戶。
• 參數：accountId，issueIdOrKey。

query_assignable

• 目的：在項目中查找可分配的用戶。
• 參數：project_key。

add_attachment

• 目的：向工單添加附件。
• 參數：issueIdOrKey，imageUrl。