MCP JIRA Python 🚀

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

インストール

# Install the server locally
git clone https://github.com/kallows/mcp-jira-python.git 

Related MCP server: Jira MCP Server

利用可能なツール

この 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 の場所は次のとおりです。

%AppData%\\Claude\\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 - 統合テストとシステム テストでは次の環境変数が必要なので、テストが環境変数を取得しやすくするためのコードを追加します。

export JIRA_HOST="your-domain.atlassian.net"
export JIRA_EMAIL="your-email@example.com"
export JIRA_API_TOKEN="your-api-token"

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

プロジェクト構造

mcp-jira-python/
├── README.md
├── pyproject.toml
├── src/
│   └── jira_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_jira_api.py
    ├── test_jira_integration.py
    └── test_jira_mcp_system.py