JIRA MCP サーバー
標準化されたツールとコンテキストを通じて、大規模言語モデル(LLM)がJIRAと連携できるようにするMCPサーバー。このサーバーは、JQLを使用した課題検索機能と、課題の詳細情報の取得機能を提供します。
特徴
JQL 検索: ページネーションサポートを使用して複雑な JQL クエリを実行します。
問題の詳細: 特定の JIRA 問題に関する詳細情報を取得します
Related MCP server: Python Jira MCP Server
前提条件
npmがインストールされているAPIアクセスを持つJIRAインスタンス
JIRA APIトークンまたは個人アクセストークン
APIトークンに関連付けられたJIRAユーザーのメールアドレス
JIRA API 認証情報の取得
https://id.atlassian.comで Atlassian アカウントにログインします。
セキュリティ設定に移動する
APIトークンの下で、「APIトークンを作成」を選択します
トークンに意味のある名前を付けます(例:「MCP Server」)
生成されたトークンをコピーします。再度表示することはできません。
このトークンを
JIRA_API_KEYとして使用しますAtlassian アカウントに関連付けられたメールアドレスを
JIRA_USER_EMAILとして使用します。
使用法
Claude Desktopとの統合
Claude Desktop の設定ファイルにサーバー設定を追加します。
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json
新しい構成を読み込むには、Claude Desktop を再起動します。
利用可能なツール
1. JQL検索( jql_search )
カスタマイズ可能なパラメータを使用して JQL 検索クエリを実行します。
パラメータ:
jql(必須): JQLクエリ文字列nextPageToken: ページネーションのトークンmaxResults: 返される結果の最大数fields: 含めるフィールド名の配列expand: 含める追加情報
例:
2. 問題を取得する ( get_issue )
特定の問題に関する詳細情報を取得します。
パラメータ:
issueIdOrKey(必須): 問題IDまたはキーfields: 含めるフィールド名の配列expand: 含める追加情報properties: 含めるプロパティの配列failFast: エラー発生時にすぐに失敗するかどうか
例:
発達
構成
サーバーを実行する前に環境変数を設定してください。ルートディレクトリに.envファイルを作成してください。
値を次のように置き換えます。
実際の JIRA インスタンス URL
JIRAアカウントに関連付けられたメールアドレス
JIRA APIトークン(Atlassianアカウント設定で生成できます)
インストール
Smithery経由でインストール
Smithery経由で Claude Desktop 用の JIRA を自動的にインストールするには:
手動インストール
このリポジトリをクローンします:
依存関係をインストールします:
MCP Inspectorで実行
テストと開発には、MCP Inspector を使用できます。
新しいツールの追加
新しいツールを追加するには、 index.jsのListToolsRequestSchemaハンドラーを変更します。
次に、 CallToolRequestSchemaハンドラーにツールを実装します。
ライセンス
マサチューセッツ工科大学
貢献
貢献を歓迎します!お気軽にPRを送信してください。