MCP Jira 統合

Jiraを使用するチームのプロジェクトマネージャーやパーソナルアシスタントとしてLLMが機能できるようにする、シンプルなModel Context Protocol (MCP) サーバーです。Jira REST API v3に基づいて構築されています。

機能

コアMCPツール

• create_issue - 適切なフォーマットとADF説明を使用して新しいJira課題を作成

• search_issues - スマートフォーマットとページネーションを使用してJQLで課題を検索

• get_sprint_status - メトリクスを含む包括的なスプリント進捗レポートを取得

• get_team_workload - チームメンバーのワークロードとキャパシティを分析

• generate_standup_report - 日次スタンドアップレポートを自動生成

プロジェクト管理機能

• マルチプロジェクトサポート: プロジェクトキーを動的に指定することで複数のプロジェクトに対応

• 視覚的なインジケーターによるスプリント進捗追跡

• チームのワークロード分析とキャパシティプランニング

• 自動日次スタンドアップレポート生成

• 適切な優先順位付けを伴う課題作成

• 課題のスマート検索とフィルタリング

信頼性

• レート制限 (429) および一時的なエラー (503) に対する指数バックオフを用いた自動リトライ

• 大規模な結果セットに対するページネーション

• タイムゾーンを考慮した日付処理

• カスタムJiraステータスおよび課題タイプの適切な処理

Related MCP server: JIRA MCP Server

要件

• Python 3.8 以上

• APIトークンを持つJira Cloudアカウント

• MCP互換クライアント (Claude Desktopなど)

クイックセットアップ

1. クローンとインストール:

git clone https://github.com/your-org/mcp-jira.git
cd mcp-jira
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. Jira認証情報の設定:

cp .env.example .env
# Edit .env with your values

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your.email@domain.com
JIRA_API_TOKEN=your_api_token
PROJECT_KEY=PROJ
DEFAULT_BOARD_ID=123

3. サーバーのテスト:

.venv/bin/python -m mcp_jira

出力に Initializing MCP Jira server... と表示されるはずです。停止するには Ctrl+C を押してください。

使用例

課題の作成

"ログインシステムが正しく動作しないという優先度の高いバグを作成して"

• 適切な課題タイプ、優先度、フォーマットを自動割り当て

スプリント管理

"現在のスプリント状況はどうですか？"

• メトリクスと視覚的インジケーターを含む包括的な進捗レポートを取得

チーム管理

"john.doe, jane.smith, mike.wilson のチームワークロードを表示して"

• キャパシティを分析し、ワークロードの分布を提供

日次スタンドアップ

"今日のスタンドアップレポートを生成して"

• 完了、進行中、ブロックされた項目を含むフォーマット済みレポートを作成

MCP統合

Claude Desktopでの利用

設定ファイルは以下の場所にあります:

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

• Windows: %APPDATA%\Claude\claude_desktop_config.json

以下のエントリを追加し、/path/to/mcp-jira をリポジトリをクローンした絶対パスに置き換えてください:

{
  "mcpServers": {
    "mcp-jira": {
      "command": "/path/to/mcp-jira/.venv/bin/python",
      "args": ["-m", "mcp_jira"]
    }
  }
}

注: .venv フォルダ内のPythonバイナリを使用してください。これにより、すべての依存関係が利用可能であることが保証されます。cwd フィールドは必須ではありません。サーバーは内部で絶対パスを使用して設定を解決します。

正しいパスを見つけるには、プロジェクトディレクトリ内で以下を実行してください:

echo "$(pwd)/.venv/bin/python"

設定を保存した後、Claude Desktopを再起動してください。

その他のMCPクライアントでの利用

このサーバーは標準のMCPプロトコルに従っており、MCP互換クライアントであればどれでも動作します。

設定

必須環境変数

• JIRA_URL - JiraインスタンスのURL

• JIRA_USERNAME - Jiraのユーザー名/メールアドレス

• JIRA_API_TOKEN - Jira APIトークン

• PROJECT_KEY - 操作のデフォルトプロジェクトキー（リクエストごとに上書き可能）

オプション設定

• DEFAULT_BOARD_ID - スプリント操作のデフォルトボード（リクエストごとに上書き可能）

• STORY_POINTS_FIELD - ストーリーポイントのカスタムフィールドID（デフォルト: customfield_10026）

• DEBUG_MODE - デバッグログの有効化（デフォルト: false）

• LOG_LEVEL - ログレベル（デフォルト: INFO）

Jira APIトークンの取得

1. Atlassianアカウント設定 に移動

2. 「APIトークンを作成」をクリック

3. 名前を付けてトークンをコピー

4. ユーザー名としてメールアドレス、パスワードとしてトークンを使用

アーキテクチャ

この実装はシンプルさと信頼性を優先しています:

• 単一のMCPサーバーファイル - すべてのツールを1か所に集約

• 標準MCPプロトコル - 公式MCP SDKを使用

• Jira REST API v3 - 説明にAtlassian Document Format (ADF) を使用

• リッチなフォーマット - 美しく読みやすいレポートを提供

• バックオフ付きリトライ - レート制限や一時的なJira APIエラーを自動的に処理

• ページネーション - 大規模な課題セットの全結果を取得

• エラーハンドリング - Jira APIの問題やカスタムステータスを適切に処理

• 非同期サポート - 高速で応答性の高い操作

トラブルシューティング

よくある問題

1. "No active sprint found"

   • ボードにアクティブなスプリントがあることを確認してください

   • DEFAULT_BOARD_ID が正しく設定されているか確認してください

2. 認証エラー

   • APIトークンが正しいか確認してください

   • ユーザー名がメールアドレスであることを確認してください

3. 権限エラー

   • Jiraユーザーが適切なプロジェクト権限を持っていることを確認してください

   • プロジェクトキーが存在し、アクセス権があることを確認してください

デバッグモード

詳細なログを取得するには、.env ファイルで DEBUG_MODE=true を設定してください。

開発

1. リポジトリをフォーク

2. 開発環境をセットアップ:

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

3. テストを実行:

python -m pytest tests/ -v

4. プルリクエストを送信

ライセンス

MITライセンス - LICENSEファイルを参照