Jira MCP

🚀 redhat-ai-tools/jira-mcp

Jiraにアクセスするための、Cursor用のコンテナ化されたPython MCPサーバーです。

⚠️ 重要提示

このプロジェクトは実験的なもので、当初は学習用に作成されました。 より機能的で成熟したJira MCPソリューションが存在することに注意してください。 例えば sooperset/mcp-atlassian や、Atlassian自身の MCP Server です。

Red Hat Jiraデータにアクセスする別の方法を提供する redhat-ai-tools/jira-mcp-snowflake も参照してください。

🚀 クイックスタート

前提条件

• 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を設定する
   これにより、この ような ~/.rh-jira-mcp.env ファイルも作成されます。

make setup

3. Jiraトークンを準備する
   • Red Hat Jira Personal Access Tokens にアクセスし、トークンを作成します。
   • ホームディレクトリの .rh-jira-mcp.env ファイルを編集し、トークンを貼り付けます。

動作を確認するには、Cursorを起動し、設定に移動して「Tools & Integrations」をクリックします。MCP Toolsの下に、20個のツールが有効になった「jiraMcp」が表示されるはずです。

✨ 主な機能

この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の下部ペインの「Output」タブに移動し、ドロップダウンから「MCP Logs」を選択し、そこにあるログを確認します。

接続問題が発生した場合

• 設定を変更した後は、Cursorを再起動します。
• Cursorの開発者コンソールでエラーメッセージを確認します。
• JiraのURLがネットワークからアクセス可能であることを確認します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。