Jira MCP サーバー

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

インストール

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

{
  "mcpServers": {
    "JiraMCP_Published": {
      "command": "npx",
      "args": [
        "@timbreeding/jira-mcp-server@latest",
        "--jira-base-url=https://example.atlassian.net",
        "--jira-username=someJiraUserEmail@domain.com",
        "--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 に配置できます。

利用可能なツール

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

コア 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 : ウィザードのコンテキスト内で問題の詳細を分析します。

発達

テストの実行

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

npm test

コード品質チェック

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

npm run check-codebase

MCP Inspectorで実行

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

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

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

ライセンス

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

Jira MCP Toolset

Integrations