JIRA MCPツール

Claude Desktop を介して JIRA API と対話するためのモデル コンテキスト プロトコル (MCP)。

特徴

• JQL (JIRA クエリ言語) を使用して JIRA の問題を検索する
• 認証されたユーザーの JIRA プロジェクトを一覧表示する
• JIRA の問題の作成、更新、削除
• コメントを追加し、ステータス間の移行の問題を報告します
• ユーザーの検索（GDPRコンプライアンスサポート付き）

インストール

1. このリポジトリをクローンします:
   git clone https://github.com/yourusername/mcp-jira.git cd mcp-jira
2. 仮想環境を作成してアクティブ化します。
   # On macOS/Linux python -m venv venv source venv/bin/activate # On Windows python -m venv venv .\venv\Scripts\activate
3. 依存関係をインストールします:
   pip install -r requirements.txt
4. プロジェクト ルートに.envファイルを作成します。
   touch .env
5. JIRA 資格情報を.envファイルに追加します。
   JIRA_SERVER=https://your-domain.atlassian.net JIRA_EMAIL=your.email@example.com JIRA_API_TOKEN=your_api_token_here
6. インストールをテストします。
   # Run all tests python -m pytest # Run a specific test file python -m pytest tests/test_search_issues.py
7. MCP サーバーを起動します。
   python run.py

環境設定

JIRA APIトークン

JIRA インスタンスで認証するには、JIRA API トークンが必要です。

1. Atlassianアカウントにログイン
2. アカウント設定 > セキュリティ > APIトークンの作成と管理に移動します
3. 「APIトークンを作成」をクリックします
4. 名前を付けます（例：「Claude Desktop Integration」）
5. 「作成」をクリックし、生成されたトークンを安全に保存します

GDPRコンプライアンス

JIRA Cloud インスタンス (GDPR 厳格モードである可能性が高い) を使用している場合:

1. ユーザー検索は表示名とメールアドレスのみに一致します
2. ユーザー名ベースの検索はサポートされていません
3. 結果はユーザーの権限に基づいて制限される場合があります
4. このツールはGDPRの要件を自動的に処理しますが、検索パターンを調整する必要がある場合があります。

トラブルシューティング

よくある問題と解決策:

1. ModuleNotFoundError: 'src' という名前のモジュールがありません
   # Run with PYTHONPATH set PYTHONPATH=/path/to/mcp-jira python run.py
2. JIRA API認証エラー
   • APIトークンが正しいことを確認してください
   • メールアドレスがAtlassianアカウントと一致していることを確認してください
   • JIRAインスタンスURLが正しく、「https://」が含まれていることを確認してください。
3. GDPR関連のエラー
   • 「ユーザー名パラメータがサポートされていません」というエラーが表示される場合、インスタンスはGDPRモードになっています。
   • 検索にはユーザー名の代わりに表示名またはメールアドレスを使用します
   • このツールは、GDPR準拠のためにAPI呼び出しを自動的に調整します。

JIRA APIトークンの取得

1. Atlassianアカウントにログイン
2. アカウント設定 > セキュリティ > APIトークンの作成と管理に移動します
3. 「APIトークンを作成」をクリックします
4. 名前を付けます（例：「Claude Desktop Integration」）
5. 「作成」をクリックし、生成されたトークンを安全に保存します

ツール

検索の問題

JQL (JIRA クエリ言語) を使用して JIRA の問題を検索します。

パラメータ:

• jql: JIRA クエリ言語文字列 (例: "project=DEMO AND status=Open")
• max_results: 返される結果の最大数（デフォルト: 10）
• フィールド: 結果に含めるフィールドのコンマ区切りリスト (デフォルト: "summary,status,assignee,priority,issuetype")

問題を作成

指定されたプロジェクトに新しい JIRA 問題を作成します。

パラメータ:

• project_key: 問題を作成するプロジェクトのキー（例："DEMO"）
• 概要: 問題の概要
• description: 問題の説明（オプション）
• issue_type: 問題の種類 (デフォルト: 「タスク」、または「バグ」、「ストーリー」など)
• 優先度: 問題の優先度（オプション、「高」、「中」、「低」など）
• 担当者: 問題を割り当てるユーザー名（オプション）

アップデートの問題

既存の JIRA 問題を新しい値で更新します。

パラメータ:

• issue_key: JIRA 課題キー (例: "PROJ-123")
• summary: 問題の新しい概要（オプション）
• 説明: 問題の新しい説明（オプション）
• ステータス: 問題の新しいステータス (オプション、例: 「進行中」、「完了」)
• 優先度: 問題の新しい優先度（オプション、例：「高」、「中」、「低」）
• 担当者: 課題の新しい担当者（オプション）
• comment: 問題に追加するコメント（オプション）

問題を削除

JIRA の問題を削除します (明示的な確認が必要です)。

パラメータ:

• issue_key: JIRA 課題キー (例: "PROJ-123")
• 確認: 誤って削除されないようにするための確認フラグ。True に設定する必要があります。

プロジェクトの一覧

認証されたユーザーの JIRA プロジェクトを一覧表示します。

パラメータ:

• limit: 返されるプロジェクトの最大数（デフォルト: 10）

コメントを追加

既存の JIRA 問題にコメントを追加します。

パラメータ:

• issue_key: JIRA 課題キー (例: "PROJ-123")
• コメント: 問題に追加するコメントテキスト

移行問題

JIRA の問題を新しいステータスに移行します。

パラメータ:

• issue_key: JIRA 課題キー (例: "PROJ-123")
• ステータス: 問題を遷移させる目標ステータス (例: 「進行中」、「完了」)
• コメント: トランジション時に追加するオプションのコメント

問題の詳細を取得する

JIRA の問題に関する詳細情報を取得します。

パラメータ:

• issue_key: JIRA 課題キー (例: "PROJ-123")
• include_comments: レスポンスに問題コメントを含めるかどうか（デフォルト: False）

ユーザーを検索

名前、メールアドレス、またはユーザー名でJIRAユーザーを検索できます。このツールは、課題の割り当てやウォッチャーの追加が必要な際にユーザーを見つけるのに役立ちます。

重要事項：GDPR厳格モードが有効になっているJIRA Cloudインスタンス（新しいインスタンスではデフォルト）の場合、ユーザー検索にはusernameではなくqueryパラメータを使用する必要があります。ツールはこれを自動的に処理しますが、状況に応じて検索パターンを調整する必要がある場合があります。

パラメータ:

• query (str): ユーザーの表示名とメールアドレスと照合する検索文字列
  • GDPR準拠のインスタンスの場合、表示名とメールアドレスを検索します
  • 検索は大文字と小文字を区別せず、部分的な文字列に一致します
  • 例: 「john」は「John Doe」と「 johnny@example.com 」に一致します。
• max_results (int, オプション): 返されるユーザーの最大数 (デフォルト: 10)
• include_active_users (bool, オプション): 検索結果にアクティブユーザーを含める (デフォルト: True)
• include_inactive_users (bool, オプション): 検索結果に非アクティブなユーザーを含める (デフォルト: False)

使用例:

GDPRコンプライアンスに関する注意事項:

• GDPR厳格モードでは、ユーザーのプライバシーを保護するためにユーザー検索がより制限されます。
• 検索はユーザーの表示名とメールアドレスのみに一致します
• ユーザー名の正確な一致はサポートされていません
• 検索は常に大文字と小文字を区別しません
• 部分一致がサポートされています（例：「jo」は「John」と一致します）
• 結果はユーザーの権限とプライバシー設定に基づいて制限される場合があります

使用例

発達

この MCP を変更または拡張したい開発者向け:

1. リポジトリをクローンする
2. 仮想環境をセットアップする: python -m venv venv && source venv/bin/activate
3. 依存関係をインストールします: pip install -r requirements.txt
4. テストを実行: python -m pytest
5. 変更を加える
6. Claude Desktopでテスト