Git Jira MCP Server

Git Jira MCP サーバー

現在の Git ブランチ名に基づいて、対応する Jira 要件の詳細を自動的に取得する MCP サーバーです。

機能

• ブランチの自動識別：現在の Git ブランチ名から Jira ID を自動的に抽出します
• 複数環境への対応：VSCode、Warp など、さまざまな開発環境に対応しています（v1.0.15 以降）
• スマートな作業ディレクトリの検出：複数階層の作業ディレクトリ検出戦略により、さまざまな環境で Git リポジトリを正しく識別します
• 要件情報の取得：次のような Jira 要件の詳細情報を取得します。
  • 要件タイトル
  • 要件の説明
  • 要件のステータス
  • 優先度
  • 担当者
• エラー処理：次のような明確なエラーメッセージを表示します。
  • ブランチ名の形式が正しくない
  • API リクエストの失敗
  • 環境変数の不足
  • Git リポジトリの識別エラー

使用方法

Jira API トークンを取得する

{
  "git-jira": {
      "command": "npx",
      "args": [
        "-y",
        "git-jira-mcp-server"
      ],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-domain.atlassian.net",
        "JIRA_USER_EMAIL": "[email protected]",
        "JIRA_API_KEY": "your_api_token",
        "JIRA_BRANCH_PATTERNS": "dev_[a-zA-Z]+-([A-Z]+-\\d+),feature/[a-zA-Z]+-([A-Z]+-\\d+),bugfix/[a-zA-Z]+-([A-Z]+-\\d+),dev_[a-zA-Z]+_([A-Z]+-\\d+)"
      }
    } 
}

ブランチの命名規則

次のブランチ名の形式に対応しています。

• dev_[name]-[JIRA-ID]
• feature/[name]-[JIRA-ID]
• bugfix/[name]-[JIRA-ID]

例：

• dev_feature-ABC-123
• feature/new-ui-ABC-123
• bugfix/login-ABC-123

更新履歴

v1.0.15 (2025-08-21)

🎉 大幅な改善：VSCode 以外の環境で Git リポジトリを識別できない問題を修正しました

• ✨ 複数階層の作業ディレクトリ検出戦略を追加：WORKSPACE_FOLDER_PATHS（VSCode）→ PWD → process.cwd()
• 🔧 Warp ターミナルなどの環境で fatal: not a git repository エラーが発生する問題を修正
• 🏗️ Git インスタンスの初期化をリファクタリングし、createGitInstance() ヘルパー関数に統一
• 🐛 エラー処理を強化し、より詳細なデバッグ情報を提供
• 📦 環境間の互換性を向上し、VSCode、Warp、iTerm など、さまざまなターミナル環境に対応

影響範囲：このバージョンでは主に、さまざまな開発環境における MCP サーバーの互換性の問題を解決しました。特に、Warp などの独立したターミナルで Git リポジトリを正しく識別できない問題を修正しました。

v1.0.14 以前

• 基本的な Jira 要件情報の取得機能
• VSCode 環境での Git ブランチ識別に対応
• Jira ID による要件情報の検索に対応