Jira MCP サーバー

Jira 用のモデル コンテキスト プロトコルサーバー。

MCP を通じて Jira との統合を提供し、LLM が Jira と対話できるようにします。

Jira REST API ドキュメント

インストール

手動インストール

注: Node バージョン 22.12.0 以上が必要です

1. Jira 個人アクセス トークンを作成または取得する: ガイド

2. Claude Desktop にサーバー設定を追加します。

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows:このガイドを確認してください

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@parassolanki/jira-mcp-server@latest"],
      "env": {
        "JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
        "JIRA_BASE_URL": "jira_base_url"
      }
    }
  }
}

Windowsの場合:

{
  "mcpServers": {
    "jira": {
      "command": "cmd /c npx",
      "args": ["-y", "@parassolanki/jira-mcp-server@latest"],
      "env": {
        "JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
        "JIRA_BASE_URL": "jira_base_url"
      }
    }
  }
}

Related MCP server: Jira MCP Server

コンポーネント

ツール

1. list_projects : Jira からプロジェクトを一覧表示します。

   • 必要な入力:

     • query (オプションの文字列): 返されるプロジェクトをフィルタリングするために使用されるクエリ文字列。

     • maxResults (オプションの数値、最大: 100): 返される結果の最大数。

     • expand (オプションの文字列): レスポンス内の追加情報を展開します。(カンマ区切りのdescription 、 lead 、 issueTypes 、 url 、 projectKeys 、 permissions 、 insight )。

2. list_boards : プロジェクトからボードを一覧表示します。

   • 必要な入力:

     • projectKeyOrId (文字列): プロジェクトのキーまたは ID。

     • name (オプションの文字列): プロジェクトの名前。

     • maxResults (オプションの数値、最大: 100): 返される結果の最大数。

     • startAt (オプションの数値): 返されるボードの開始インデックス。

     • type (オプションの文字列): ボードのタイプ。( scrumまたはkanbanのいずれかになります)。

3. list_sprints_from_board : ボードからスプリントを一覧表示します。

   • 必要な入力:

     • boardId (文字列): ボードの ID。

     • maxResults (オプションの数値、最大: 100): 返される結果の最大数。

     • startAt (オプションの数値): 返されるボードの開始インデックス。

4. list_issues_from_sprint : スプリントからの問題を一覧表示します。

   • 必要な入力:

     • boardId (文字列): ボードの ID。

     • sprintId (文字列): スプリントの ID。

     • maxResults (オプションの数値、最大: 100): 返される結果の最大数。

     • startAt (オプションの数値): 返されるボードの開始インデックス。

     • expand (オプションの文字列): レスポンス内の追加情報を展開します。( schemaとnamesコンマで区切ります)。

5. create_issue : Jira で問題を作成します (タスク問題タイプのみサポートされます)。

   • 必要な入力:

     • projectKeyOrId (文字列): プロジェクトのキーまたは ID。

     • summary (文字列): 問題の概要/タイトル。

     • description (文字列): 問題の説明。

使用例

Jira と対話するために使用できるプロンプトの例:

1. 「すべての Jira プロジェクトを表示」→ list_projects ツールを実行して、利用可能なすべてのプロジェクトを表示します。

2. 「DEV プロジェクトにはどのようなカンバン ボードが存在しますか?」 → DEV プロジェクト キーとタイプ パラメータを「kanban」に設定して list_boards ツールを実行します。

3. 「ボード ID 123 のすべてのスプリントを表示する」→ list_sprints_from_board ツールを実行して、ボード 123 に関連付けられているすべてのスプリントを表示します。

4. 「ボード 123 のスプリント 456 にはどのような問題がありますか?」 → ボード 123 のスプリント 456 にあるすべての問題を表示するには、list_issues_from_sprint ツールを実行します。

5. 「マーケティング ボードの現在のスプリントの最初の 50 件の問題を表示します」→ 最初に list_boards を実行してマーケティング ボード ID を見つけ、次に list_sprints_from_board を実行して現在のスプリントを見つけ、最後に maxResults=50 で list_issues_from_sprint を実行します。

発達

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

pnpm install

2. .envで Github アクセス トークンを設定します。

JIRA_PERSONAL_ACCESS_TOKEN=email@example.com:your_personal_jira_access_token
JIRA_BASE_URL=jira_base_url

3. watch を使用してローカルで実行します。

pnpm dev

4. サーバーを構築します。

pnpm build

5. インスペクタを使用したローカルデバッグ:

pnpm inspector

すべて

• [x] プロジェクト一覧

• [x] リストボード

• [x] ボードからのスプリントのリスト

• [x] スプリントからの問題リスト

• [ ] IDまたはキーで問題を取得

• [x] create_issue（タスク課題タイプのみ）

• [ ] create_issue（ストーリー、エピック、サブタスクの課題タイプ）

• [ ] 更新問題

• [ ] 問題を削除する

• [ ] 号をアーカイブする

• [ ] 問題からのコメントリスト

• [ ] IDで問題からコメントを取得する

• [ ] 問題にコメントを作成する

• [ ] 問題に関するコメントの更新

• [ ] 問題のコメントを削除

• [ ] 問題からのサブタスクのリスト

• [ ] ユーザー名またはキーでユーザーを取得する