Jira MCP Server

Jira MCP サーバー

Jira 用の Model Context Protocol サーバーです。

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 protected]: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 protected]:your_personal_jira_access_token",
        "JIRA_BASE_URL": "jira_base_url"
      }
    }
  }
}

コンポーネント

ツール

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 プロジェクトにはどの Kanban ボードがある？」→ DEV プロジェクトのキーを指定し、type パラメーターを「kanban」に設定して list_boards ツールを実行します。
3. 「ボード ID 123 のすべてのスプリントを表示して」→ list_sprints_from_board ツールを実行して、ボード 123 に関連付けられているすべてのスプリントを確認します。
4. 「ボード 123 のスプリント 456 にはどの課題がある？」→ list_issues_from_sprint ツールを実行して、ボード 123 のスプリント 456 にあるすべての課題を確認します。
5. 「Marketing ボードの現在のスプリントから最初の 50 件の課題を表示して」→ まず list_boards を実行して Marketing ボードの ID を見つけ、次に list_sprints_from_board で現在のスプリントを見つけてから、maxResults=50 を指定して list_issues_from_sprint を実行します。

開発

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

pnpm install

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

[email protected]:your_personal_jira_access_token
JIRA_BASE_URL=jira_base_url

3. ウォッチモードでローカル実行します：

pnpm dev

4. サーバーをビルドします：

pnpm build

5. インスペクターを使用してローカルデバッグします：

pnpm inspector

TODO

• list_projects
• list_boards
• list_sprints_from_board
• list_issues_from_sprint
• get_issue_by_id_or_key
• create_issue（タスクの課題タイプのみ）
• create_issue（ストーリー、エピック、サブタスクの課題タイプ）
• update_issue
• delete_an_issue
• archieve_an_issue
• list_comments_from_issue
• get_comment_from_issue_by_id
• create_comment_in_issue
• update_comment_of_issue
• delete_comment_of_issue
• list_subtasks_from_issue
• get_user_by_username_or_key