Jira MCP

Jira MCP

実際のソフトウェア開発で培った長年の経験をもとに構築した、独自の考え方を反映した Jira MCP サーバーです。

汎用的な Jira 連携とは異なり、この MCP はエンジニアや自動化 QC チームの日々のワークフローをもとに設計されています。課題に関連付けられたすべてのプルリクエストの取得、複雑なスプリント移行の管理、ワークフロー全体にわたる開発情報の追跡など、実際の開発ニーズに応える高度なツールを利用できます。

これは単なる API ラッパーではありません。スプリントの管理、開発作業の追跡、リリースの調整、チーム間の可視性の維持など、プロフェッショナルが実際に Jira をどのように使っているかを反映しています。すべてのツールは、現代のソフトウェア開発で発生する現実的な問題の解決を目的に設計されています。

利用可能なツール

課題管理

• jira_get_issue - ステータス、担当者、説明、サブタスク、利用可能なトランジションなど、特定の課題の詳細情報を取得します
• jira_create_issue - 指定した詳細情報で新しい課題を作成します（キー、ID、URL を返します）
• jira_create_child_issue - 親課題に紐づく子課題（サブタスク）を作成します
• jira_update_issue - 既存の課題の詳細を変更します（一部の項目のみの更新に対応）
• jira_list_issue_types - プロジェクトで利用可能なすべての課題タイプを、ID、名前、説明とともに一覧表示します

検索

• jira_search_issue - カスタマイズ可能なフィールドと展開オプションを指定し、JQL（Jira Query Language）を使って課題を検索します

スプリント管理

• jira_list_sprints - 特定のボードまたはプロジェクトの、すべてのアクティブなスプリントと今後のスプリントを一覧表示します
• jira_get_sprint - ID を指定して、特定のスプリントの詳細情報を取得します
• jira_get_active_sprint - 指定したボードまたはプロジェクトの現在アクティブなスプリントを取得します
• jira_search_sprint_by_name - 完全一致または部分一致で、名前を使ってスプリントを検索します

ステータスとトランジション

• jira_list_statuses - プロジェクトで利用可能なすべての課題ステータスの ID と名前を取得します
• jira_transition_issue - 有効なトランジション ID を使って、ワークフロー内で課題を移行します

コメント

• jira_add_comment - 課題にコメントを追加します（Atlassian Document Format を使用）
• jira_get_comments - 課題のすべてのコメントを取得します

作業ログ

• jira_add_worklog - 課題に費やした時間を記録する作業ログを追加します

履歴と監査

• jira_get_issue_history - 課題の変更履歴全体を取得します

課題の関連付け

• jira_get_related_issues - 関連付け（ブロック、ブロックされている、関連するなど）がある課題を取得します
• jira_link_issues - 2 つの課題の関係を定義して、課題間のリンクを作成します

バージョン管理

• jira_get_version - 特定のプロジェクトバージョンの詳細情報を取得します
• jira_list_project_versions - プロジェクト内のすべてのバージョンを詳細情報とともに一覧表示します

開発情報

• jira_get_development_information - 開発ツール連携（GitHub、GitLab、Bitbucket）を通じて課題に紐づけられたブランチ、プルリクエスト、コミットを取得します

インストール

このプロンプトを AI アシスタントにコピーしてください：

Install the Jira MCP server (https://github.com/nguyenvanduocit/jira-mcp) for my Claude Desktop or Cursor IDE. Read the MCP documentation carefully and guide me through the installation step by step.

AI アシスタントがこのインストールを支援できない場合、設定に問題があるか、AI ツールの性能が不十分であることを示しています。有能な AI アシスタントであれば、MCP のインストールを案内できるはずです。

CLI の使用方法

MCP サーバーに加えて、jira-mcp には、MCP クライアントを必要とせずにターミナルから直接使えるスタンドアロンの CLI バイナリ（jira-cli）が同梱されています。

インストール

just install-cli
# or
go install github.com/nguyenvanduocit/jira-mcp/cmd/jira-cli@latest

クイックスタート

export ATLASSIAN_HOST=your-instance.atlassian.net
export [email protected]
export ATLASSIAN_TOKEN=your-api-token
# or
jira-cli --env .env <command> [flags]

コマンド

コマンド	説明
get-issue	課題の詳細を取得します
search-issues	JQL で課題を検索します
create-issue	新しい課題を作成します
update-issue	既存の課題を更新します
add-comment	課題にコメントを追加します
list-comments	課題のコメント一覧を取得します
get-transitions	利用可能なステータス遷移を取得します
transition-issue	課題を新しいステータスに遷移させます
list-sprints	ボードのスプリント一覧を取得します
get-worklogs	課題の作業ログを取得します
add-worklog	課題の作業を記録します
get-history	課題の変更履歴を取得します

例

# Get an issue
jira-cli get-issue --issue-key PROJ-123

# Search with JQL
jira-cli search-issues --jql "project = PROJ AND status = 'In Progress'" --max-results 20

# Create an issue
jira-cli create-issue --project PROJ --summary "Fix login bug" --type Bug

# Transition issue
jira-cli get-transitions --issue-key PROJ-123
jira-cli transition-issue --issue-key PROJ-123 --transition-id 31

# JSON output
jira-cli search-issues --jql "assignee = currentUser()" --output json | jq '.[].key'

フラグ

すべてのコマンドで次のフラグを使用できます：

• --env string — .env ファイルへのパス
• --output string — 出力形式：text（デフォルト）または json

ライセンス

MIT — LICENSE を参照してください。

AI 向け

このセクションは AI 専用です

このコードベースを扱う際は、プロジェクト構造を理解するために次のファイルを読んでください：

1. CLAUDE.md - アーキテクチャ、開発コマンド、コーディング規約を含む包括的なプロジェクトドキュメント
2. main.go - MCP サーバーの初期化方法とツールの登録方法を示すエントリーポイント
3. services/jira_client.go - シングルトン Jira クライアントの初期化と認証
4. tools/ - 一貫したパターンに従った個々のツール実装
5. docs/ - 詳細なドキュメント（以下の構成を参照）

主な概念：

• これは AI アシスタントを Jira に接続する、Go ベースの MCP サーバーです
• 各ツールは、型付き入力検証を備えた登録とハンドラーのパターンに従います
• ツールはカテゴリ別（課題、スプリント、コメント、作業ログなど）に整理されています
• すべての Jira 操作で github.com/ctreminiom/go-atlassian クライアントライブラリを使用します
• 開発原則は .specify/memory/constitution.md に記載されています

変更を加える前に、次の内容を確認してください：

• アーキテクチャパターンと開発コマンドについては CLAUDE.md
• ガバナンス原則については .specify/memory/constitution.md

クイックスタート

1) API トークンを取得する

https://id.atlassian.com/manage-profile/security/api-tokens で作成します。

2) Cursor に追加する

Docker またはローカルバイナリを使用します（STDIO、ポートは不要です）。

Docker

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ATLASSIAN_HOST=https://your-company.atlassian.net",
        "-e", "[email protected]",
        "-e", "ATLASSIAN_TOKEN=your-api-token",
        "ghcr.io/nguyenvanduocit/jira-mcp:latest"
      ]
    }
  }
}

バイナリ

{
  "mcpServers": {
    "jira": {
      "command": "/usr/local/bin/jira-mcp",
      "env": {
        "ATLASSIAN_HOST": "https://your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "[email protected]",
        "ATLASSIAN_TOKEN": "your-api-token"
      }
    }
  }
}

3) Cursor で試す

• 「自分に割り当てられている課題を表示して」
• 「ABC の現在のスプリントには何がある？」
• 「ABC で Safari でログインできないバグを作成して」

設定

• ATLASSIAN_HOST: https://your-company.atlassian.net
• ATLASSIAN_EMAIL: Atlassian のメールアドレス
• ATLASSIAN_TOKEN: API トークン

任意の .env（ローカルで実行する場合）：

ATLASSIAN_HOST=https://your-company.atlassian.net
[email protected]
ATLASSIAN_TOKEN=your-api-token

HTTP モード（任意、デバッグ用）：

jira-mcp -env .env -http_port 3000

Cursor の設定（HTTP モード）：

{ "mcpServers": { "jira": { "url": "http://localhost:3000/mcp" } } }

公開するツールを制限する（ENABLED_TOOLS）

デフォルトでは、すべての Jira ツールが登録されます。一部のツールのみを公開するには（たとえば、AI エージェントに Jira の読み取り専用ビューを提供する場合）、ENABLED_TOOLS 環境変数にツール名をカンマ区切りの許可リストとして設定します：

ENABLED_TOOLS=jira_get_issue,jira_search_issue,jira_get_comments

ルール：

• 未設定または空の場合 → すべてのツールが公開されます（後方互換性があります）。
• 名前の前後の空白は許容されます。
• 不明な名前は無視されますが、起動時にログへ記録されるため、入力ミスをすぐに確認できます。
• リストにない名前のツールは登録されないため、MCP クライアントには表示されません。

読み取り専用エージェントの例（読み取りツールを 15 個公開し、変更を伴うツールを 8 個すべてブロックします）：

ENABLED_TOOLS=jira_get_issue,jira_search_issue,jira_list_statuses,jira_get_comments,jira_get_issue_history,jira_get_related_issues,jira_list_sprints,jira_get_sprint,jira_get_active_sprint,jira_search_sprint_by_name,jira_get_version,jira_list_project_versions,jira_get_development_information,jira_download_attachment,jira_list_issue_types

インストール

Homebrew（macOS/Linux）

brew install nguyenvanduocit/tap/jira-mcp