MCP Server Atlassian Jira

🚀 Atlassian Jira MCP 服務器

本項目提供了一個模型上下文協議（MCP）服務器，它就像一座橋樑，連接著人工智能助手（例如 Anthropic 的 Claude、Cursor AI 或其他兼容 MCP 的客戶端）與您的 Atlassian Jira 實例。藉助這個服務器，人工智能能夠即時且安全地訪問和與您的項目、問題及其他 Jira 資源進行交互。

🚀 快速開始

先決條件

• Node.js 和 npm：需要 Node.js 14 或更高版本以及 npm 5+。
• Jira API 訪問權限：確保您的 Jira 實例允許通過 API 進行訪問。
• 管理員權限：可能需要管理員權限來配置 API 訪問和憑證。

獲取 Atlassian API 令牌

要與 Jira 交互，您需要一個用於身份驗證的 API 令牌，獲取步驟如下：

1. 登錄到您的 Jira 賬戶。
2. 進入 Jira 設置 > 用戶 profile。
3. 找到並點擊 API tokens 部分。
4. 創建一個新的 API 令牌並保存它。

配置憑據

方法 A: 使用配置文件

創建或編輯 ~/.jira/config 文件，添加以下內容：

{
    "environments": {
        "default": {
            "url": "https://your-domain.atlassian.net",
            "email": "your.email@example.com",
            "api-token": "your_api_token"
        }
    }
}

方法 B: 命令行配置

運行以下命令並按提示輸入信息：

mcp-atlassian-jira config

連接人工智能助手

將服務器與您的 AI 助手集成，可按以下步驟操作：

1. 安裝並運行服務器：

npm install -g @aashari/mcp-server-atlassian-jira
mcp-atlassian-jira start

2. 配置 API 端點：在您的 AI 助手中設置 Jira 數據源，指向 MCP 服務器的地址。
3. 開始交互：

# 示例: 獲取項目信息
mcp-atlassian-jira get-project --project-key-or-id YOUR_PROJECT_KEY

✨ 主要特性

什麼是 MCP？

模型上下文協議（MCP）是一個開放標準，它能讓人工智能系統安全且上下文相關地連接到外部工具和數據源。此服務器針對 Jira Cloud 實現了 MCP，將您的 Jira 數據與人工智能助手橋接起來。

為什麼使用此服務器？

• 最小輸入，最大輸出理念：只需簡單的標識符（如項目名稱或問題 ID），即可獲取豐富的信息。
• 直接從 Jira 獲取數據：支持 JQL 查詢和直接的問題/項目檢索。
• 強大的集成能力：與人工智能助手無縫配合，提供即時的 Jira 上下文。

📦 安裝指南

命令行界面 (CLI)

快速使用（通過 npx）

npx -y @aashari/mcp-server-atlassian-jira ls-projects
npx -y @aashari/mcp-server-atlassian-jira get-issue --issue-id-or-key PROJ-123

全局安裝

npm install -g @aashari/mcp-server-atlassian-jira
mcp-atlassian-jira ls-projects

獲取幫助

使用 --help 查看所有命令的選項和用法：

mcp-atlassian-jira --help
mcp-atlassian-jira ls-projects --help

💻 使用示例

基礎用法

以下是一些常用命令的示例：

ls-projects - 列出所有項目

mcp-atlassian-jira ls-projects

get-project - 獲取項目詳細信息

mcp-atlassian-jira get-project --project-key-or-id YOUR_PROJECT_KEY

ls-issues - 根據 JQL 查詢問題

mcp-atlassian-jira ls-issues --jql "project = DEV AND status = 'In Progress'"

get-issue - 獲取問題詳細信息

mcp-atlassian-jira get-issue --issue-id-or-key PROJ-123

📄 許可證

本項目採用 ISC License。