Jira MCP Server

Jira MCP サーバー

Model Context Protocol（MCP）を介して Jira と連携するためのツール集です。Jira の主要な機能と、統一されたガイド付きの課題作成・更新ウィザードを提供します。

インストール

クライアントにインストールするには、次の手順に従います。

{
  "mcpServers": {
    "JiraMCP_Published": {
      "command": "npx",
      "args": [
        "@timbreeding/jira-mcp-server@latest",
        "--jira-base-url=https://example.atlassian.net",
        "[email protected]",
        "--jira-api-token=<your jira token>"
      ],
      "env": {
        "DEBUG": "true",
        "LOG_FILE_PATH": "" // Some full path. If blank, it will not write logs to a file.
      }
    }
  }
}

使用方法

...

設定

環境変数

ローカルで実行する場合は、DEBUG と LOG_FILE_PATH を .env に記述できます。

利用可能なツール

このアプリケーションでは、Model Context Protocol を介して次のツールを利用できます。

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 はテスト用に設定されています。テストスイートを実行するには、次のコマンドを使用します。

npm test

コード品質チェック

型チェック、リント、テストをまとめて実行するには、次のコマンドを使用します。

npm run check-codebase

MCP Inspector での実行

Model Context Protocol Inspector を使用してローカルで開発・テストするには、アプリケーションを起動し、必要な環境変数を -e フラグで渡します。

npx @modelcontextprotocol/inspector -e JIRA_BASE_URL=https://your-domain.atlassian.net -e [email protected] -e JIRA_API_TOKEN=your-api-token -e DEBUG=true node build/index.js

（build/index.js を使用する場合は、先にプロジェクトをビルドしてください）

ライセンス

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