Jira MCP Server 9ga

🚀 Jira MCP 服務器

Jira MCP 服務器是一個藉助 jira-python 庫與 Jira REST API 進行交互的 Model Context Protocol (MCP) 服務器。它能夠與 Claude Desktop 及其他 MCP 客戶端集成，支持您通過自然語言命令與 Jira 展開交互。

✨ 主要特性

• 📋 獲取所有可訪問的 Jira 項目
• 📑 獲取特定 Jira 問題的詳細信息
• 🔍 使用 JQL（Jira 查詢語言）搜索問題
• ➕ 創建新的 Jira 問題
• 💬 向問題添加評論
• 🔄 獲取問題的可用過渡狀態
• 🚀 將問題過渡到新狀態

📦 安裝指南

先決條件

• 🐍 Python 3.9 或更高版本
• 🌐 Jira 實例（雲、服務器或數據中心）
• 📦 uv（可選但推薦用於依賴管理）

激活虛擬環境（推薦）

# 在 mcp 服務器目錄中安裝一個虛擬環境
python -m venv .
# 激活虛擬環境
source bin/activate

使用 uv（推薦）

# 如果您沒有安裝 uv，請先安裝
pip install uv

# 安裝 Jira MCP 服務器
uv pip install mcp-server-jira

使用 pip

pip install mcp-server-jira

🛠️ 配置

環境變量

使用環境變量配置服務器：

• JIRA_SERVER_URL：Jira 服務器 URL
• JIRA_AUTH_METHOD：身份驗證方法（'basic_auth' 或 'token_auth'）
• JIRA_USERNAME：基本認證用戶名
• JIRA_PASSWORD：基本認證密碼
• JIRA_TOKEN：API 令牌或個人訪問令牌

環境文件（本地開發）

您也可以在根目錄中創建一個 .env 文件，其中包含您的配置：

JIRA_SERVER_URL=https://your-jira-instance.atlassian.net
JIRA_AUTH_METHOD=basic_auth
JIRA_USERNAME=your_email@example.com
JIRA_TOKEN=your_api_token

💻 使用示例

命令行

python -m mcp_server_jira

Docker

docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jira

🤝 Claude Desktop 集成

要將此服務器與 Claude Desktop 集成：

1. 使用上述方法之一安裝服務器
2. 在 Claude Desktop 中：
   • 轉到設置 -> 開發人員
   • 點擊編輯配置
   • 在您選擇的編輯器中打開 JSON 配置文件
   • 添加以下 JSON： （注意：使用的環境變量適用於令牌身份驗證，與其他身份驗證方法不兼容）

{
  "mcpServers": {
    "jira": {
      "command": "<UV 安裝路徑> 例如 /Users/<用戶名>/.local/bin/uv",
      "args": [
          "--directory",
          "<JIRA MCP 路徑>",
          "run",
          "mcp-server-jira"
      ],
      "env": {
          "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
          "JIRA_AUTH_METHOD": "token_auth",
          "JIRA_USERNAME": "<您的 Jira 用戶名>",
          "JIRA_TOKEN": "<您的訪問令牌>"
        }
    }
  }
}

📄 許可證

本項目採用 MIT 許可證。