MCP-JIRA-Python Server

MCP JIRA Python 🚀

JIRAとの連携のためのMCPサーバーのPython実装です。MCPは、AIにツールを提供し、データを安全（必要に応じてローカル）に保つために設計された通信プロトコルです。サーバーはAIアプリケーションと同じコンピュータ上で実行され、Claude DesktopはMCPサーバーを実行する最初のアプリケーションです（クライアントとみなされます。シンプルなPython MCPクライアントについては、examplesフォルダをご覧ください）。

インストール

利用可能なツール

この MCP サーバーは、次の JIRA 統合ツールを提供します。

• delete_issue : 課題キーを使用して Jira 課題またはサブタスクを削除します。
• create_jira_issue : 概要、説明、タイプ、優先度、担当者などのカスタマイズ可能なフィールドを持つ新しい Jira の問題を作成します。
• get_issue : 指定された問題キーのコメントや添付ファイルを含む完全な問題の詳細を取得します。
• create_issue_link : 問題間の関係を作成します (例: 「ブロック」、「ブロックされている」など)
• update_issue : 要約、説明、ステータス、優先度、担当者などのフィールドの新しい値で既存の問題を更新します。
• get_user : メールアドレスを使用してユーザーのアカウントIDを検索する
• list_fields : 利用可能なすべての JIRA フィールドとそのプロパティのリストを取得します。
• list_issue_types : JIRAインスタンスで利用可能なすべての課題タイプを取得します
• list_link_types : 問題リンクの可能なすべての関係タイプを取得します
• search_issues : 特定のプロジェクト内で JQL (JIRA クエリ言語) を使用して課題を検索します
• add_comment : 既存の問題にテキストコメントを追加する
• add_comment_with_attachment : 添付ファイル付きのコメントを問題に追加する

クロードデスクトップ構成

これにはclaude_desktop_config.jsonの更新が必要です。ファイルの場所はApple、Windows、Linuxによって異なります。

ウィンドウズ

注: Windows での claude_desktop_config.json の場所は次のとおりです。

これは（通常）次のように解決されます：C:\Users\YOURUSERNAME\AppData\Roaming\Claude

以下はclaude_desktop_config.jsonに追加する設定ブロックです。Windowsでは常にフルパスを使用します。「command」を更新し、ディレクトリパスを設定し、JIRAの環境設定を追加します。

☠️警告 - 更新された claude_desktop_config.json を有効にするには、Claude Desktop を閉じて、すべての Claude プロセスを強制終了する必要があります。😬

MacとLinux

ファイルパスを mcp-jira-python に更新し、JIRA 環境変数を入力します。

注記：

claude_desktop_config.json への変更を保存した後、Claude Desktop を再起動する必要があります。

MCP JIRA Pythonツールの実行

これらのMCPツールはjira-apiサーバーの下にリストされています。Claudeデスクトップのテキスト入力ボックスの右下にある小さなハンマーをクリックすると、リストが表示されます。jira-apiツールがリストに表示されていることを確認してください。ツールを「実行」するには、ClaudeにJiraタスクを実行するよう具体的に指示してください。ただし、最初はツールが表示されず、Claudeに促す必要がある場合があります。場合によっては、ツールの使用を拒否することもあります。システムプロンプトを更新することをお勧めします。

テストの実行

TODO - テストの実行の説明を追加します (unittest) TODO - 統合テストとシステム テストでは次の環境変数が必要なので、テストが環境変数を取得しやすくするためのコードを追加します。

TODO - テスト カバレッジ レポートを生成する:

プロジェクト構造