MCP Jira Python

🚀 MCP JIRA Python

一個用於JIRA集成的MCP服務器的Python實現。MCP是一種通信協議，旨在為您的AI提供工具，同時保障數據安全（如有需要，還能實現本地化）。該服務器與您的AI應用程序在同一臺計算機上運行，Claude Desktop是首個運行MCP服務器的應用程序（同時也是客戶端，您可查看examples文件夾中的簡單Python MCP客戶端示例）。

🚀 快速開始

本項目是用於JIRA集成的MCP服務器的Python實現，能為AI提供工具並保障數據安全。以下是使用前的準備步驟。

📦 安裝指南

# 在本地安裝服務器
git clone https://github.com/kallows/mcp-jira-python.git 

✨ 主要特性

此MCP服務器提供了以下JIRA集成工具：

• delete_issue：使用問題密鑰刪除Jira問題或子任務
• create_jira_issue：創建新Jira問題，支持自定義字段，包括標題、描述、類型、優先級和分配人
• get_issue：獲取給定問題密鑰的完整問題詳細信息，包括評論和附件
• create_issue_link：創建問題之間的關係（例如“阻止”“被阻止”等）
• update_issue：更新現有問題，設置新的字段值，如標題、描述、狀態、優先級或分配人
• get_user：使用電子郵件地址查找用戶的賬戶ID
• list_fields：獲取JIRA所有可用字段及其屬性的列表
• list_issue_types：檢索您JIRA實例中的所有可用問題類型
• list_link_types：獲取問題鏈接的所有可能關係類型
• search_issues：使用JQL（JIRA查詢語言）在特定項目中搜索問題
• add_comment：向現有問題添加文本評論
• add_comment_with_attachment：為帶有附件的問題添加評論

📚 詳細文檔

Claude Desktop配置

這需要您更新claude_desktop_config.json。文件的位置因Apple、Windows或Linux而異。

Windows

⚠️ 重要提示

在Windows中，您必須關閉Claude Desktop並終止所有Claude進程，才能啟用更新後的claude_desktop_config.json！

注意：在Windows中，claude_desktop_config.json的路徑為：

%AppData%\\Claude\\claude_desktop_config.json

這通常會解析到：C:\\Users\\YOURUSERNAME\\AppData\\Roaming\\Claude

下面是需要添加到claude_desktop_config.json的配置塊。在Windows中，我們始終使用完整路徑。您將更新"command"，設置您的目錄路徑，並添加JIRA環境設置。

    "jira-api": {
      "command": "C:\\\\Users\\\\YOURUSERNAME\\\\.local\\\\bin\\\\uv.exe",
      "args": [
        "--directory",
        "D:\\\\mcp\\\\mcp-jira-python",
        "run",
        "-m",
        "mcp_jira_python.server"
      ],
      "env": {
        "JIRA_HOST": "YOURNAME.atlassian.net",
        "JIRA_EMAIL": "yourname@example.com",
        "JIRA_API_TOKEN": "YOURJIRATOKEN"
      }      
    }

Mac/Linux

將以下內容添加到claude_desktop_config.json：

    "jira-api": {
      "command": "python3",
      "args": [
        "-m",
        "mcp_jira_python.server"
      ],
      "env": {
        "JIRA_HOST": "YOURNAME.atlassian.net",
        "JIRA_EMAIL": "yourname@example.com",
        "JIRA_API_TOKEN": "YOURJIRATOKEN"
      }      
    }

同樣，您需要在終端中運行：

python3 -m mcp_jira_python.server

項目結構

MCP-JIRA-Python/
├── src/
│   └── jira_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_jira_api.py
    ├── test_jira_integration.py
    └── test_jira_mcp_system.py