Jira CLI MCP Server

Jira CLI MCP サーバー

jira-cli コマンドラインツールをラップし、AI アシスタントが Jira を操作できるようにする MCP（Model Context Protocol）サーバーです。

jira-cli-mcp を選ぶ理由

Jira MCP サーバーをお探しの場合、jira-cli-mcp には次のような特長があります。

• 🚀 既存のツールを活用 - お使いの jira-cli の設定や認証とシームレスに連携します
• 🔒 セキュリティを最優先 - 設定ファイルに API トークンを保存せず、認証は jira-cli が処理します
• 🪶 軽量 - Bun プロセスだけで動作し、Docker やコンテナは不要です

mcp-atlassian を使う場合

次のような場合は、mcp-atlassian を選択してください。

• Confluence のサポートが必要（このツールは Jira 専用です）
• Docker によるデプロイを希望する
• CLI に依存しない自己完結型のソリューションが必要
• CLI をラップするのではなく、API と直接連携したい

機能

• create_ticket - カスタマイズ可能なフィールドを指定して Jira チケットを新規作成します
• list_tickets - JQL クエリを使って Jira チケットを検索、一覧表示します
• get_ticket - コメントを含むチケットの詳細情報を取得します
• update_ticket_description - リッチテキスト形式でチケットの説明を更新します
• add_comment - Markdown に対応したコメントをチケットに追加します
• assign_to_me - チケットを現在のユーザーに割り当てます
• move_ticket - チケットを別のステータスに移動します
• open_ticket_in_browser - Jira チケットを既定のウェブブラウザーで開きます

クイックスタート

1. jira-cli をインストールして設定します（インストールガイド）。

   # Install jira-cli (macOS)
   brew install ankitpokhrel/jira-cli/jira-cli
   
   # Configure jira-cli with your Jira instance
   jira init
   

2. jira-cli-mcp をインストールします。

   brew tap choplin/jira-cli-mcp
   brew install jira-cli-mcp
   

3. Claude Desktop の設定に追加します（以下のClaude Desktop の設定を参照）。

前提条件

• jira-cli がインストールされ、認証済みであること
• Bun ランタイム（開発時またはソースからインストールする場合のみ必要）

インストール

オプション 1：Homebrew でインストール（macOS/Linux）

brew tap choplin/jira-cli-mcp
brew install jira-cli-mcp

オプション 2：npm でインストール

# Install globally with npm
npm install -g @choplin/jira-cli-mcp

# Or with Bun
bun install -g @choplin/jira-cli-mcp

オプション 3：バイナリをダウンロード

リリースページから、お使いのプラットフォーム用のコンパイル済みバイナリをダウンロードします。

• macOS（Apple Silicon）：jira-cli-mcp-darwin-arm64.tar.gz
• macOS（Intel）：jira-cli-mcp-darwin-x64.tar.gz
• Linux（x64）：jira-cli-mcp-linux-x64.tar.gz
• Linux（ARM64）：jira-cli-mcp-linux-arm64.tar.gz

# Example for macOS (Apple Silicon)
tar -xzf jira-cli-mcp-darwin-arm64.tar.gz
chmod +x jira-cli-mcp-darwin-arm64
sudo mv jira-cli-mcp-darwin-arm64 /usr/local/bin/jira-cli-mcp

オプション 4：ソースからビルド

git clone https://github.com/choplin/jira-cli-mcp.git
cd jira-cli-mcp
bun install
bun run build:prod

Claude Desktop の設定

オプション 1：Homebrew でインストールする（推奨）

クイックスタートの手順に従って Homebrew でインストールした場合は、claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}

オプション 2：npm パッケージを使用する

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "jira-cli": {
      "command": "npx",
      "args": ["@choplin/jira-cli-mcp"]
    }
  }
}

グローバルにインストールした場合は、次のようにします。

{
  "mcpServers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}

オプション 3：コンパイル済みバイナリを使用する（依存関係なし）

1. リリースから、お使いのプラットフォーム用のバイナリをダウンロードします
2. 展開して PATH に移動します。

tar -xzf jira-cli-mcp-darwin-arm64.tar.gz
sudo mv jira-cli-mcp-darwin-arm64 /usr/local/bin/jira-cli-mcp

1. 設定に追加します。

{
  "mcpServers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}

オプション 4：ソースからビルド

1. クローンして直接実行します。

git clone https://github.com/choplin/jira-cli-mcp.git
cd jira-cli-mcp
bun install

1. 設定に追加します。

{
  "mcpServers": {
    "jira-cli": {
      "command": "bun",
      "args": ["run", "/path/to/jira-cli-mcp/src/index.ts"]
    }
  }
}

設定ファイルの場所

設定ファイルは通常、次の場所にあります。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

動作確認

設定後、Claude Desktop を再起動し、利用可能な Jira ツールについて Claude に質問して、MCP サーバーが読み込まれていることを確認します。

その他の AI アシスタントの設定

Claude Code

Claude Code には MCP サーバーのサポートが組み込まれています。プロジェクトで jira-cli-mcp を使用するには：

1. まず、インストール セクションに記載されている方法のいずれかで jira-cli-mcp をインストールします

2. プロジェクトのルートに .claude/mcp.json ファイルを作成します：

{
  "servers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}

1. Claude Code を再起動すると、MCP サーバーが自動的に読み込まれます

会話で次のような Jira コマンドを直接使用できます：

• 「自分の未解決の Jira チケットを一覧表示して」
• 「PROJ-123 の詳細を表示して」
• 「PROJ-456 にコメントを追加して」

GitHub Copilot（VS Code）

GitHub Copilot は Visual Studio Code（バージョン 1.99 以降）で MCP サーバーをサポートしています：

1. まず、インストール セクションに記載されている方法のいずれかで jira-cli-mcp をインストールします

2. リポジトリに .vscode/mcp.json を作成します：

{
  "servers": {
    "jira-cli": {
      "command": "jira-cli-mcp"
    }
  }
}

1. VS Code で .vscode/mcp.json ファイルを開き、[Start] ボタンをクリックしてサーバーを有効にします

2. Copilot Chat で：

   • Copilot Chat パネルを開きます
   • ポップアップメニューから「Agent」を選択します
   • ツールアイコンをクリックして、利用可能な MCP サーバーを確認します

注：GitHub Copilot の MCP サポートは現在、パブリックプレビュー版です。

開発

テストの実行

# Run unit tests only
bun test

# Run all tests including integration tests
bun run test:integration

# Run integration tests with a specific test ticket
JIRA_CLI_MCP_TEST_TICKET=PROJ-123 bun run test:integration

環境変数

• JIRA_CLI_PATH - jira-cli 実行ファイルのカスタムパス（デフォルト：「jira」）

開発環境変数

• JIRA_CLI_MCP_TEST_TICKET - 統合テスト用のチケットキー（一覧取得以外の統合テストで必須）
• INTEGRATION_TEST=true - 統合テストを有効にします

型チェック

bun run typecheck

リントとフォーマット

bun run lint
bun run format

アーキテクチャ

• src/tools/ - MCP ツールの実装
• src/utils/ - 共通ユーティリティと型
• tests/ - jira-cli をモックした単体テスト
• tests/integration/ - 実際の jira-cli を使用する統合テスト

注記

• サーバーはリッチテキストの処理に Atlassian Document Format（ADF）を使用します
• Markdown 入力は jira-cli によって自動的に ADF に変換されます
• すべての統合テストには、jira-cli の適切な認証が必要です

トラブルシューティング

よくある問題

1. 「jira-cli が見つかりません」エラー

   • jira-cli がインストールされていることを確認します：which jira
   • カスタムパスを使用する場合は、JIRA_CLI_PATH 環境変数を設定します

2. 認証エラー

   • jira me を実行して認証を確認します
   • 必要に応じて jira init で再認証します

3. Claude Desktop に MCP サーバーが表示されない

   • 設定ファイルのパスが正しいことを確認します
   • 設定内のパスが相対パスではなく絶対パスであることを確認します
   • 設定を変更した後、Claude Desktop を再起動します

4. macOS での権限エラー

   • システム設定で、ターミナル／Claude Desktop にフルディスクアクセスを許可します
   • jira-cli に必要な権限があることを確認します

デバッグモード

詳細なログを確認するには、サーバーを手動で実行できます：

cd /path/to/jira-cli-mcp
bun run src/index.ts

ライセンス

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