MCP Server Jira

🚀 JIRA交互MCP服務器

這是一個提供與JIRA交互工具的Model Context Protocol (MCP)服務器。它允許您通過MCP接口獲取活動Sprint中的門票以及詳細的問題信息，為JIRA項目管理提供便利。

🚀 快速開始

配置完成後，您可以通過MCP接口在Claude中使用這些工具，實現與JIRA的交互。

✨ 主要特性

該服務器提供了以下工具：

1. list-sprint-tickets：獲取指定項目中活動Sprint的所有門票
   • 必要參數：projectKey（字符串）
2. get-ticket-details：獲取特定問題的詳細信息
   • 必要參數：issueKey（字符串）
3. add-comment：在特定問題上添加評論
   • 必要參數：issueKey（字符串）
   • 必要參數：comment（字符串）
4. link-tickets：使用'相關於'關係鏈接兩個問題
   • 必要參數：sourceIssueKey（字符串）
   • 必要參數：targetIssueKey（字符串）
5. update-description：更新特定問題的描述
   • 必要參數：issueKey（字符串）
   • 必要參數：description（字符串）
6. list-child-issues：獲取父問題的所有子問題
   • 必要參數：parentKey（字符串）
7. create-sub-ticket：為父問題創建子問題（子任務）
   • 必要參數：parentKey（字符串）
   • 必要參數：summary（字符串）
   • 可選參數：description（字符串）
   • 可選參數：issueType（字符串）- 子任務問題類型的名稱（例如：'子任務'）

📦 安裝指南

1. 安裝依賴：

   npm install
   

2. 構建TypeScript代碼： 僅在Windows上使用Cline時需要此步驟，因為當前Cline在Windows上執行npx存在問題。

   npm run build
   

3. 在Claude應用程序設置文件中配置MCP參數（通常位於~/Library/Application Support/Claude/claude_desktop_config.json macOS或%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json Windows）： Claude的設置：

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["path/to/this/repo/jira.ts"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cline的設置：

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["path/to/this/repo/dist/jira.js"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

💻 使用示例

基礎用法

列出Sprint門票

要獲取項目中活動Sprint的所有門票：

<use_mcp_tool>
<server_name>jira</server_name>
<tool_name>list-sprint-tickets</tool_name>
<arguments>
{
  "projectKey": "YOUR_PROJECT_KEY"
}
</arguments>
</use_mcp_tool>

獲取問題詳細信息

要獲取特定問題的詳細信息：

<use_mcp_tool>
<server_name>jira</server_name>
<tool_name>get-ticket-details</tool_name>
<arguments>
{
  "issueKey": "PROJECT-123"
}
</arguments>
</use_mcp_tool>

📚 詳細文檔

配置

您需要在MCP設置中配置以下環境變量：

1. JIRA_HOST：您的Atlassian域名URL（例如，https://your-company.atlassian.net）
2. JIRA_EMAIL：您的JIRA賬戶電子郵件
3. JIRA_API_TOKEN：您的JIRA API令牌
   • 您可以從Atlassian賬戶設置生成API令牌

開發

服務器使用TypeScript編寫，並且使用：

• @modelcontextprotocol/sdk：MCP協議的SDK
• node-fetch：用於發送HTTP請求
• dotenv：加載環境變量

要運行此項目，請按照以下步驟操作：

1. 克隆倉庫
2. 安裝依賴：

   npm install
   

3. 啟動服務器：

   npm start
   

錯誤處理

該工具處理以下錯誤：

• 無效的項目密鑰或問題密鑰
• 網絡錯誤
• 無效的評論或其他輸入參數

錯誤消息將以JSON格式返回，其中包含error字段。