JIRA MCP Server

JIRA MCP サーバー

セルフホスト型 JIRA との連携に対応する Model Context Protocol（MCP）サーバーです。標準化されたインターフェースを通じて、AI アシスタントが JIRA の課題やプロジェクトを操作できます。

機能

• JIRA プロジェクトの一覧を取得
• JQL を使用して JIRA のタスクを検索
• タスクの詳細を取得
• 新しいタスクを作成
• タスクにコメントを追加
• タスクのフィールド（要約、説明、担当者、優先度、ラベル、期限、カスタムフィールド）を更新。ステータスと同時に更新することもできます
• タスクのステータスを更新（ステータス名、トランジション名、または ID を指定）
• タスクの担当者を更新
• 利用可能なタスクのステータスを取得
• タスクの添付ファイルを取得
• ファイル名を指定してタスクの添付ファイルをダウンロード

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします：

npm install

3. .env.example を .env にコピーして環境変数を設定します：

cp .env.example .env

4. JIRA の認証情報を .env ファイルに設定します：

JIRA_HOST=your.jira.host
JIRA_USERNAME=yourname
JIRA_PASSWORD=yourpassword
# Or use access token authentication:
# JIRA_ACCESS_TOKEN=yourtoken

使い方

MCP サーバーを起動します：

npm start

サーバーが起動し、MCP 対応の AI アシスタントに登録されます。

利用可能なツール

downloadTaskAttachment

ファイル名を指定して、JIRA タスクから特定の添付ファイルをダウンロードします。

パラメーター：

• taskId（string、必須）：JIRA タスク ID（例：PROJECT-123）
• filename（string、必須）：ダウンロードする添付ファイルの正確なファイル名

レスポンス： 次のメタデータを含む、Base64 エンコードされたバイナリデータを返します：

• filename：ダウンロードしたファイルの名前
• mimeType：ファイルの MIME タイプ
• size：ファイルサイズ（バイト）
• content：ファイルの内容を Base64 エンコードしたデータ

使用例：

{
  "taskId": "PROJECT-123",
  "filename": "document.pdf"
}

この関数は、正確なファイル名がわかっている場合に JIRA タスクから特定の添付ファイルを取得するのに便利です。ファイルをダウンロードし、プログラムから処理できます。

依存関係

• @modelcontextprotocol/sdk
• jira-client
• dotenv
• zod

作者

• 名前：Rix Beck
• GitHub：rixbeck

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。

Copyright (c) 2025 Rix Beck

本ソフトウェアおよび関連ドキュメントファイル（以下「ソフトウェア」）のコピーを入手したすべての人に対し、ソフトウェアを無償で取り扱うことを許可します。これには、ソフトウェアの使用、複製、変更、結合、公開、頒布、サブライセンス、および販売の権利が含まれますが、これらに限定されません。また、ソフトウェアを提供された人にこれらの権利を許可することも認められます。ただし、以下の条件に従うものとします。

上記の著作権表示および本許諾表示は、ソフトウェアのすべてのコピーまたは実質的な部分に含めるものとします。

本ソフトウェアは「現状のまま」提供され、明示的か黙示的かを問わず、いかなる保証もありません。これには、商品性、特定目的への適合性、および権利非侵害の保証が含まれますが、これらに限定されません。著作者または著作権者は、契約、不法行為、その他の行為に起因するかを問わず、ソフトウェアまたはその使用、その他の取引に関連して発生したいかなる請求、損害、その他の責任についても責任を負いません。