Jira MCP Toolset

Jira MCP サーバー

モデル コンテキスト プロトコル (MCP) を介して Jira と対話するために設計されたツールのコレクションで、Jira のコア機能と、統合されたガイド付きの問題作成および更新ウィザードを提供します。

インストール

これをクライアントにインストールするには:

使用法

...

構成

環境変数

ローカルで実行するには、DEBUG と LOG_FILE_PATH を .env に配置できます。

利用可能なツール

このアプリケーションは、モデル コンテキスト プロトコルを介して次のツールを公開します。

コア Jira ツール

• getJiraIssue : キーによって Jira 課題を取得します。
• analyzeJiraIssue : Jira の問題の包括的な分析を実行します。
• jiraGet : 任意の Jira API GET エンドポイントからデータを取得します。
• getIssuesByJql : JQL クエリを使用して Jira の問題を検索します。

問題作成ウィザードツール

これらのツールは、Jira の新しい課題を作成するためのステップバイステップのガイド付きプロセスを提供します。ウィザードは作成フロー全体を通して状態を維持し、通常は以下の段階が含まれます：プロセスの開始、プロジェクトの選択 ( getProjects )、課題タイプの選択 ( getIssueTypes )、必要なフィールドの取得と入力 ( getFields 、 updateFields )、オプションで課題の詳細の分析、そして最後に課題の確認と作成 ( createIssue )。進行状況を監視するにはgetStateとgetStatus使用し、最初からやり直すにはresetState使用します。

• issueCreation_getState : ウィザードの現在の内部状態を取得します。
• issueCreation_getStatus : ウィザードの高レベルのステータスを取得します。
• issueCreation_initiateState : 新しいウィザードの状態を初期化します。
• issueCreation_resetState : ウィザードの状態をリセットします。
• issueCreation_updateState : ウィザードの状態 (プロジェクト、問題タイプ、フィールド、ステップ) を更新します。
• issueCreation_createIssue : ウィザードの状態を使用して Jira の問題を作成します。
• issueCreation_getProjects : 利用可能な Jira プロジェクトを取得します。
• issueCreation_getIssueTypes : 選択したプロジェクトで利用可能な問題タイプを取得します。
• issueCreation_getFields : 選択したプロジェクト/問題タイプに必要なフィールドを取得します。
• issueCreation_updateFields : ウィザード状態の特定のフィールド値を更新します。
• issueCreation_setAnalysisComplete : 分析完了フラグを設定します。
• issueCreation_setUserConfirmation : 作成前にユーザー確認フラグを設定します。
• issueCreation_analyzeIssue : ウィザードのコンテキスト内で問題の詳細を分析します。

問題更新ウィザードツール（統合更新ワークフロー）

これらのツールは、Jira のあらゆる課題（新規作成または既存）を更新するための、統一された堅牢なメカニズムを提供します。すべての更新は、単一の一貫したワークフローで実行されます。

• issueUpdateWizard_loadIssueIntoState : キーで Jira の問題を取得し、統合された更新ワークフローの状態マネージャーにロードします。
• issueUpdateWizard_updateIssueFromState : 現在の状態 (フィールド、プロジェクト、タイプなど) を使用して、読み込まれたすべての問題を更新します。

主要原則:

• すべての問題の更新 (新規または既存) は同じパターンに従います。つまり、問題を状態に読み込み、フィールドを変更し、API 経由で更新します。
• 新しい問題の更新と既存の問題の更新の間でコードの重複はありません。
• 最小限かつ明示的かつ堅牢なエラー処理。
• 更新操作の 100% ユニット テスト カバレッジ。

発達

テストの実行

Jestはテスト用に設定されています。テストスイートを実行するには、以下の手順を実行してください。

コード品質チェック

型チェック、リンティング、テストを一緒に実行するには:

MCP Inspectorで実行

モデル コンテキスト プロトコル インスペクターを使用したローカル開発およびテストでは、アプリケーションを起動し、 -eフラグを使用して必要な環境変数を渡すことができます。

( build/index.jsを使用する場合は、まずプロジェクトをビルドしたことを確認してください)

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。