Jira MCP

🚀 redhat-ai-tools/jira-mcp

這是一個容器化的Python MCP服務器，專為Cursor設計，用於訪問Jira。

🚀 快速開始

本項目具有實驗性質，最初是作為學習練習創建的。需要注意的是，市面上有更強大、更成熟的Jira MCP解決方案，例如 sooperset/mcp-atlassian 以及Atlassian官方的 MCP Server。

另請參閱 redhat-ai-tools/jira-mcp-snowflake，它提供了另一種訪問Red Hat Jira數據的方式。

📦 安裝指南

前提條件

• podman - 使用 sudo dnf install podman（Fedora/RHEL）或 brew install podman（macOS）進行安裝
• make - 大多數系統通常已預裝

操作步驟

1. 獲取代碼

git clone git@github.com:redhat-ai-tools/jira-mcp.git
cd jira-mcp

2. 構建鏡像並配置Cursor 此步驟還會創建一個類似於 example.env 的 ~/.rh-jira-mcp.env 文件。

make setup

3. 準備Jira令牌
   • 訪問 Red Hat Jira個人訪問令牌 並創建一個令牌。
   • 編輯主目錄下的 .rh-jira-mcp.env 文件，並粘貼該令牌。

要確認其是否正常工作，請運行Cursor，轉到設置並點擊“工具與集成”。在MCP工具下，您應該會看到“jiraMcp”，並且已啟用20個工具。

✨ 主要特性

此MCP服務器提供以下工具：

問題搜索

• get_jira - 按密鑰獲取特定Jira問題的詳細信息。
• search_issues - 使用JQL搜索問題。

項目管理

• list_projects - 列出所有項目。
• get_project - 按密鑰獲取項目詳細信息。
• get_project_components - 獲取項目的組件。
• get_project_versions - 獲取項目的版本。
• get_project_roles - 獲取項目的角色。
• get_project_permission_scheme - 獲取項目的權限方案。
• get_project_issue_types - 獲取項目的問題類型。

看板與衝刺管理

• list_boards - 列出所有看板。
• get_board - 按ID獲取看板詳細信息。
• list_sprints - 列出看板的衝刺。
• get_sprint - 按ID獲取衝刺詳細信息。
• get_issues_for_board - 獲取看板的問題。
• get_issues_for_sprint - 獲取衝刺的問題。

用戶管理

• search_users - 按查詢條件搜索用戶。
• get_user - 按賬戶ID獲取用戶詳細信息。
• get_current_user - 獲取當前用戶信息。
• get_assignable_users_for_project - 獲取項目的可分配用戶。
• get_assignable_users_for_issue - 獲取問題的可分配用戶。

🔧 開發命令

• make build - 構建鏡像。
• make run - 運行容器。
• make clean - 清理已構建的鏡像。
• make cursor-config - 修改 ~/.cursor/mcp.json 以安裝此MCP服務器。
• make setup - 構建鏡像、配置Cursor，並在 ~/.rh-jira-mcp.env 不存在時創建該文件。

🛠️ 故障排除

服務器未啟動

• 確認 make run 命令是否正常工作。
• 檢查 JIRA_API_TOKEN 是否正確。
• 使用 podman images jira-mcp 驗證鏡像是否成功構建。
• 轉到Cursor底部面板的“輸出”選項卡，從下拉菜單中選擇“MCP日誌”並檢查其中的日誌。

連接問題

• 在配置更改後重啟Cursor。
• 檢查Cursor的開發者控制檯是否有錯誤消息。
• 驗證Jira URL是否可以從您的網絡訪問。

📄 許可證

本項目採用MIT許可證。有關詳細信息，請參閱 LICENSE 文件。