MCP Jira

🚀 MCP Jira 集成

本項目將Claude AI與Jira深度融合，有效實現項目管理任務的自動化，顯著提升管理效率與質量。

🚀 快速開始

此項目把Claude AI和Jira結合起來，可自動化並增強項目管理任務。若要使用該項目，需滿足以下需求：

• Python 3.8 或更高版本
• 帶有 API Token 的 Jira 賬戶
• 有效的 MCP 實現

✨ 主要特性

核心功能

• 通過 MCP 協議實現 Jira 問題創建和管理
• 基於 API Key 的身份驗證
• AI 交互的標準請求/響應格式

Jira 集成功能

• 問題創建和更新
• 基礎 sprint 跟蹤
• 項目和看板管理
• 問題搜索與檢索

📦 安裝指南

1. 克隆倉庫
2. 在 .env 中配置環境變量：

   JIRA_URL=https://your-domain.atlassian.net
   JIRA_USERNAME=你的郵箱@域.com
   JIRA_API_TOKEN=你的_api_令牌
   PROJECT_KEY=PROJ
   API_KEY=你的安全_api_key  # 用於 MCP 身份驗證
   

💻 使用示例

基礎用法

創建問題

from mcp_jira.protocol import MCPRequest, MCPContext

# 創建請求上下文
context = MCPContext(
    conversation_id=\"conv-123\",
    user_id=\"user-123\",
    api_key=\"你的_api_key\"
)

# 創建問題請求
request = MCPRequest(
    function=\"create_issue\",
    parameters={
        \"summary\": \"實現功能 X\",
        \"description\": \"詳細描述\",
        \"issue_type\": \"故事\",
        \"priority\": \"高\"
    },
    context=context
)

response = await mcp_handler.process_request(request)

搜索問題

request = MCPRequest(
    function=\"search_issues\",
    parameters={
        \"jql\": \"project = PROJ AND status = '進行中'\"
    },
    context=context
)

response = await mcp_handler.process_request(request)

高級用法

認證

所有請求都需要在請求頭中包含 API Key：

headers = {
    \"X-API-Key\": \"你的_api_key\"
}

與 AI 助手集成

此 MCP 實現設計用於支持 MCP 協議的 AI 助手：

1. 配置環境變量
2. 在 AI 助手配置中設置 MCP 終端點
3. 使用標準化的 MCP 協議進行 Jira 交互

📚 詳細文檔

貢獻指南

1. 叉克倉庫
2. 創建功能分支
3. 提交拉取請求

📄 許可證

本項目採用 MIT 許可證，詳情見 LICENSE 文件。