jira-mcp

JIRA MCP サーバー

標準化されたツールとコンテキストを通じて、大規模言語モデル（LLM）がJIRAと連携できるようにするMCPサーバー。このサーバーは、JQLを使用した課題検索機能と、課題の詳細情報の取得機能を提供します。

特徴

• JQL 検索: ページネーションサポートを使用して複雑な JQL クエリを実行します。
• 問題の詳細: 特定の JIRA 問題に関する詳細情報を取得します

前提条件

• npmがインストールされている
• APIアクセスを持つJIRAインスタンス
• JIRA APIトークンまたは個人アクセストークン
• APIトークンに関連付けられたJIRAユーザーのメールアドレス

JIRA API 認証情報の取得

1. https://id.atlassian.comで Atlassian アカウントにログインします。
2. セキュリティ設定に移動する
3. APIトークンの下で、「APIトークンを作成」を選択します
4. トークンに意味のある名前を付けます（例：「MCP Server」）
5. 生成されたトークンをコピーします。再度表示することはできません。
6. このトークンをJIRA_API_KEYとして使用します
7. Atlassian アカウントに関連付けられたメールアドレスをJIRA_USER_EMAILとして使用します。

使用法

Claude Desktopとの統合

1. Claude Desktop の設定ファイルにサーバー設定を追加します。

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

2. 新しい構成を読み込むには、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 を自動的にインストールするには:

手動インストール

1. このリポジトリをクローンします:

2. 依存関係をインストールします:

MCP Inspectorで実行

テストと開発には、MCP Inspector を使用できます。

新しいツールの追加

新しいツールを追加するには、 index.jsのListToolsRequestSchemaハンドラーを変更します。

次に、 CallToolRequestSchemaハンドラーにツールを実装します。

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にPRを送信してください。